(12) INTERNATIONAL APPLICATION PUBLISHED UNDER THE PATENT COOPERATION TREATY (PCT) 



(19) World Intellectual Property Organization 
International Bureau 

(43) International Publication Date 
28 December 2000 (28.12.2000) 




PCT 



(10) International Publication Number 

WO 00/79734 Al 



(51) International Patent Classification 7 : H04L 12/28, 
H04Q 11/04 



(74) Agents: TANG, Henry et al.; Baker Botts LLP, 30 Rock- 
efeller Plaza, New York, NY 101 12-0228 (US). 



(21) International Application Number: PCT/US00/16913 

(22) Internationa! Filing Da te: 1 9 June 2000 ( 1 9.06.2000) 

(25) Filing Language: English 

(26) Publication Language: English 



(30) Priority Data: 

60/139*933 



18 June 1999 (18.06.1999) US 



(71) Applicant: THE TRUSTEES OF COLUMBIA UNI- 
VERSITY IN THE CITY OF NEW YORK [US/US]; 
1 16th Street and Broadway, New York, NY 10027 (US). 

(72) Inventors: DUTTA, Ashutosh; 560 Riverside Drive, 
Apt. 17C, New York, NY 10027 (US). SCHULZRINNE, 
Henning; 313 Westview Avenue, Leonia, NJ 07605 (US). 
YEMINI, Yechiam; 223 Promenade, Edgewater, NJ 
07020 (US). 



(81) Designated States (national): AE, AG, AL, AM, AT, AU, 
AZ, BA, BB, BG, BR, BY, BZ, CA, CH, CN, CR, CU, CZ, 
DE, DK, DM, DZ, EE, ES, FI, GB, GD, GE, GH, GM, HR, 
HU, ID, IL, IN, IS, JP, KE, KG, KP, KR, KZ, LC, LK, LR, 
LS, LT, LU, LV. MA, MD, MG, MK, MN, MW, MX, MZ, 
NO, NZ, PL, PT, RO, RU, SD, SE, SG, SI, SK, SL, TJ, TM, 
TR, TT, TZ, UA, UG, UZ, VN, YU, ZA, ZW. 

(84) Designated States (regional): ARIPO patent (GH, GM, 
KE, LS, MW, MZ, SD, SL, SZ, TZ, UG, ZW), Eurasian 
patent (AM, AZ, BY, KG, KZ, MD, RU, TJ, TM), European 
patent (AT, BE, CH, CY, DE, DK, ES, FI, FR, GB, GR, IE, 
IT, LU, MC, NL, PT, SE), OAPI patent (BF, BJ, CF, CG, 
CI, CM. GA, GN, GW, ML, MR, NE, SN, TD, TG). 

Published: 

— With international search report 

For two-letter codes and other abbreviations, refer to the "Guid- 
ance Notes on Codes and Abbreviations" appearing at the begin- 
ning of each regular issue of the PCT Gazette. 



(54) Title: 
SOURCE 



SYSTEM AND METHOD FOR RECEIVING OVER A NETWORK A BROADCAST FROM A BROADCAST 



FUNCTIONAL ARCHITEC TURE 

T(£r»crjrpt«d 
1 Audio Stream) 




Kings on tn\j 

LDcatAOMrtainQ sentcr 
tor od and local program bongs) 



O 



(57) Abstract: A system and method for providing a broadcast to a receiver (IMC 50) via a communication network (20). In partic- 
ular, the broadcast is received via at least one global multicast channel (Ml). At least one local multicast channel (1m) is associated 
with the global multicast address (Mx). Then, a communication link is established between the receiver (EMC 50) and the local 
multicast channel (lm), and the broadcast is routed from the global multicast channel (Ml) to the local multicast channel (lm) to pro- 
vide the broadcast to the receiver The number of the receivers which are receiving the broadcast may be determined The receiver 
may include an Internet Protocol (IP) interface (IP I/F) which enables the receiver to receive the broadcast via an IP-type multicast 
communication (20). The receiver may also be wireless (50), and can receive the broadcast in a first subnet (la) using a multicast 
communication. Prior to the receiver (IMC 50) moving to a second subnet (ia), a request is generated by the receiver to receive the 
broadcast in the second subnet. After receiving the request, the broadcast is provided to the wireless receiver in the second subnet 
using the multicast communication. 
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SYSTEM AND METHOD FOR RECEIVING OVER A 
NETWORK A BROADCAST FROM A BROADCAST SOURCE 



FIELD OF THE INVENTION : 

The present invention relates to a system and method for providing a 
5 broadcast over a network to a client. In particular, the system and method utilize 
network multicast communication for providing the broadcast of content between a 
broadcast source and the client to avail a global content and/or a local content to user. 



APPENDIX 

Attached hereto, please find an Appendix which shows an exemplary 
1 0 embodiment of the implementation of the system and method according to the present 
invention. 



BACKGROUND INFORMATION : 

Conventional radio systems broadcast a continuous content without 
requiring extensive user interaction. This traditional scheme is convenient in 

15 situations where the listener is sharing his or her attention with other tasks, such as 
driving an automobile. However, one of the disadvantages of these conventional 
radio systems is that only a limited number of the radio stations can legally transmit 
their broadcasts in a particular area (e.g., only 45 FM radio stations can transmit their 
broadcast in the New York City metropolitan area). There have been a number of 

20 proposed solutions to address this limitation. However, none of the proposed 

solutions effectively utilized the Internet to expand the number of radio broadcasts, as 
well as television broadcasts, to the wireless users who travel from one geographical 
area to another. 

A streaming real-time multimedia content (which relates to 

25 entertainment, music and /or interactive game industries) can now be provided over 
the Internet. The streaming applications include IP telephony, broadcasting 
multimedia content and multi-party conferences, collaborations and multi-player 
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games. However, at least one publication (i.e., the New York Times) asserted that 
such multimedia streaming applications will bring about the demise of the Internet 
because the streaming applications are far more demanding in terms of bandwidth, 
latency and reliability than the traditional data communication applications. Many of 
5 the existing streaming systems do not scale to large audiences, particularly for a 
transmission at high bit rates. They also do not provide a user flexibility, and are 
restricted u> a utilization of either conferencing or broadcast modes. 

Farly attempts to provide the streaming applications to the clients over 
the Internet have been implement using a unicast scheme. An exemplary system 

10 illustrating the system which utilizes the conventional unicast architecture is shown in 
Figure I Referring to Figure 1, the source 100 (e.g., the audio and/or video content 
provider I in connected lo a first router Rl, which in turn is connected to second and 
third router> R2, R3 The second router R2 is connected to fourth and fifth routers 
R4, R5. while the third router R3 is connected to sixth and seventh routers R6, R7. 

15 The fourth router R4 is connected to two clients CO, CI, the fifth router R5 is 

connected to three clients C2, C3, C4, the sixth client R6 is connected to two clients 
C5, C6. and the seventh client R7 is connected to another three clients C7, C8, C9. 
The clients C0-C9 may be computers requesting the particular multimedia content 
(e.g., an audio and/or video content). 

20 In operation, if each of the clients C0-C9 requests the same multimedia 

content, each of those requests is routed via their respective routers to the source 100. 
Particularly, the clients CO, CI send such request to the fourth router R4 which routes 
the request two streams for the particular multimedia content, i.e., one stream for each 
of its requesting clients CO, CI. At the same time, the fifth, sixth and seventh routers 

25 R5, R6, R7 may receive the requests for the same multimedia content from its 
respective clients C2-C9, and these routers R5, R6, R7 route their streams, 
respectively, for such multimedia content upstream. The requests for two and three 
identical multimedia streams (i.e., a total of five streams) are sent to the second router 
R2 from the fourth and fifth routers R4, R5, respectively. The requests for the same 

30 three and two multimedia streams (i.e., also a total of five streams) are sent to the 

third router R3 from the sixth and seventh routers R6, R7, respectively. The second 
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and third routers R2, R3 each route the request for five multimedia streams to the first 
router Rl, which routes a request for 10 multimedia streams (i.e., 5 for the second 
router R2 and 5 for the third router R3) to the source 100. 

Thus, the source 100 receives a request for 10 multimedia streams, and 
5 then transmits 10 multimedia streams to the first router Rl, which then routes the 
requested 5 identical multimedia streams to the second router R2, and the same 5 
multimedia streams to the third router R3. The second router R2 then routes two of 
these multimedia streams to the fourth router R4, and three to the fifth router R5. The 
fourth router R4 routes 1 stream to the client CO and the other stream to the client C 1 . 

10 The fifth router R5 routes one of its received streams to the respective client, C2, C3 5 
C4. Similar routing of the multimedia streams occurs for the third router R3 (and thus 
for the sixth and seventh routers, (R6, R7). 

By utilizing the unicast scheme described above and shown in Figure 1 , 
there may be multiple copies of the same multimedia content being transmitted from 

15 the source down to the clients. Such transmission of multiple streams may cause a 

bottleneck in the network by wasting the Internet bandwidth, and would likely prevent 
the clients from receiving the multimedia content in an expeditious manner. 

Figure 2 shows an arrangement utilizing a conventional multicast 
communications scheme which addressed at least some of the above-mentioned 

20 drawbacks. For the sake of simplicity, the multicast arrangement in Figure 2 is 
substantially similar to that shown in Figure 1 . Using the multicasting 
communications scheme illustrated in Figure 2, if each of the clients C0-C9 requests 
the same multimedia content, the routers keep track of the particular client which 
made the request, and only sends one request for the multimedia stream upstream to 

25 the next router in the chain (or to the source 100). For example, the clients CO, CI 
may send such request (e.g., a join request) to the fourth router R4, which stores an 
indication (e.g., a state) therein that at least one of clients CO, CI sent the particular 
request. At the same time, the fifth, sixth and seventh routers R5, R6, R7 may receive 
the requests for the same multimedia content from its respective clients C2-C9, and 

30 each these routers R5, R6, R7 stores an indication therein regarding that at least one of 
their respective clients sent the request for multimedia stream. If the fourth router R4 
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(or the fifth router R5) already routed the multimedia streams to one of its clients (on 
the same subnet as the requesting client), it routes the multimedia streams to such 
requesting client. Otherwise each of the fourth and fifth routers R4, R5 sends a 
request to receive the multimedia stream that was requested by their respective clients 
5 C0-C4 to the second router R2. The second router R2 stores an indication that at least 
one of the fourth and fifth routers R4, R5 made the request. Each of the sixth and 
seventh routers R6, R7 also may send a request for the multimedia stream (i.e., that 
was requested by their respective clients C5-C9) to the third router R3. The third 
router R3 stores an indication which is similar to the one stored in the second router 

10 R2. Then, the second and third routers R2, R3 each send the request for the same 

multimedia stream to the first router Rl, which stores an indication regarding which 
of the routers R2, R3 made the request. Since the first router Rl is directly connected 
(or connected in the same subnet) to the source 100, the first router Rl always 
receives the multimedia stream from the source 1 00. 

1 5 In this manner, the first router Rl receives the request, duplicates the 

received multimedia stream (via multicast channels 500) and transmits 1 copy thereof 
to each of the second and third routers R2, R3 (if both made the request). The second 
router R2 then duplicates the received multimedia stream provided in the multicast 
channels 500, and sends one copy of the stream to each of the fourth and fifth router 

20 R4, R5. The fourth router R4, in turn, provides one copy of the received multimedia 
stream provided in the multicast channels 500 to the client CO and the other copy to 
the client CI (if both made the request). The fifth router R5 duplicates the received 
multimedia stream, and sends one copy of the received multimedia stream provided 
by the multicast channels 500 to each of the respective client C2, C3, C4 (if each of 

25 theses clients made the request). A similar transmission of the multimedia streams 
occurs for the third router R3 (and thus for the sixth and seventh routers R6, R7). 

With this multicast scheme, the source 100 needs to only transmit one 
multimedia stream to the requesting router, which in turn duplicates the multimedia 
stream (if necessary) and transmits a single stream downstream to the routers and/or 

30 the clients requesting such stream. Indeed, each router (as well as the source 100) 
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does not need to transmit more than one multimedia stream to the downstream routers. 
As such, the bandwidth of the system is utilized more efficiently. 

In addition, by using the multicast scheme described above, it is also 
possible to avoid a transmission of a request for the multimedia stream (that has 
5 already been provided to other clients by a particular router) upstream, all the way up 
to the server 100. For example, another client CIO may be connected to the fourth 
router R5, and this new client CIO may request the multimedia stream from the fourth 
router R4 that has already been requested (and is provided to) the client CI . When the 
fourth router R4 receives this request from the new client CIO, it checks whether the 

10 requested multimedia stream has already been provided to it. If not, this request is 
then parsed to the second router R2. If the fourth router R4 determines that the 
requested multimedia stream is already provided by it to at least one of its clients (is in 
the present exemplary case to the client CI), the fourth router sends a copy of the 
requested multimedia stream to the new client C10 without sending additional 

15 requests for this multimedia stream to the second router R2, and ultimately to the 

server. Even though this multicast communications scheme provides an advantageous 
transmission of the multimedia streams from the servers to the clients, it was not 
effectively usable for wireless communication or in systems where the broadcast 
streams from different sources which can immediately be provided to the wired or 

20 wireless clients. 

Previous attempts to provide next-generation radio and television 
systems have not been successful largely because these systems did not add significant 
benefits over the older and well known systems. Current versions of the Internet (or 
web) radio or television were not designed to utilize a large-scale multicast scheme, 

25 while also lacking the ability to support low-latency constraints and flexible 

programming (e.g., an automatic ad insertion during a program, an on-line monitoring 
of a particular channel, etc.). Furthermore, the conventional systems do not support a 
continuous streaming or conferencing, while the wireless client is moving, especially 
from one subnet to another. 
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SUMMARY OF THE INVENTION 

A system and method according to the present invention is provided for 
transmitting and receiving broadcasts between a broadcast source and a client. One of 
the exemplary embodiments of the system and method utilizes the available Internet 
standards and protocols (e.g., RTP, RTCP, RTSP, SIP, SAP, SDP, UDP and IP 
multicast) to maximize their deployability. Other embodiments of the present 
invention utilize non-conventional technologies and/or protocols, such as a mobility- 
aware multicast scheme, a streaming protocol for wireless clients, a fast re- 
configuration, a bandwidth control for a multicast stream in a wireless network, etc. 
With the present invention, users can choose to tune-in to receive a local broadcast 
transmitted by a local station, a global broadcast transmitted by a global station. 

The system and method according to the present invention can send 
broadcasts in a single area, as well as to multiple regions, where there are 
listeners/viewers who would like to receive the broadcast. This system and method 
1 5 also provides the ability for the end user to invite another user to a particular program 
using SIP (Session Initiation Protocol). Thus, with the present invention it is now 
possible to provide: 

Scalable mechanism for a selective content distribution with an automatic 
localized information insertion by using a hierarchical scope-based 
20 multicasting (e.g., global/local multicasting scheme) and local servers. 

Application-layer multicasting arrangement for the real-time broadcast traffic. 
Scalable hierarchical directory structure for an itemized content distribution. 
Support for global and local programs with possible ways of mixing the two. 
Popularity-based spectrum management to address the limits if the spectrum 
25 (e.g., a control mechanism for managing an audio/video stream based on a 

popularity of a particular program - capable of increasing the bandwidth of the 
broadcast which provides content for broadcasts which are popular with the 
users). 

Secure payment scheme between the content providers, advertisers and 
30 affiliates, which may be utilized for E-commerce. 
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Support of a fast-handoff of the Internet Protocol multicast streams when the 
mobile clients move from one domain to another (e.g., moving in a car on a 
highway from one subnet to another) in a wireless environment. An 
application layer mobility protocol and a faster reconfiguration methodology 
5 can be provided for the wireless clients to implement such support. 

Distribution of a streaming content to the IP enabled wireless handset (e.g., IP 
enabled radio/television) using systems with wireless interface and a tuner. 
A combination of intra-ISP multicast with non-multicast global domain (e.g., 
the unicast domain). 

1 0 * Support of IP multicast scheme for streaming (e.g., using the MP3 standard) 
over the bandwidth constrained wireless medium. 
Secure multicast environment to protect against malicious data senders. 

One of the embodiments of the system of the present invention 
provides an architecture to facilitate an IP-based radio/television network, e.g., a 

1 5 streaming network. It can utilize the conventional Internet protocol suite to provide 
robust communication over conventional heterogeneous access networks. For 
example, the system and method can also utilize any wired and/or wireless layer-2 
technology such as, e.g., PPP ("point to point protocol"), CDMA ("code division 
multiple access"), protocol based on IEEE 802.1 1 standard, DSL ("digital subscriber 

20 link") and Gigabit Ethernet. It is also possible to utilize the system and method of the 
present invention other network technologies. The local servers used in the system 
and method according to the present invention, as well as the use of application layer, 
provide an degree of scalability. The flexibility of radio services a better reach and a 
quality of service for the audio/video stream carried over IP are just a few of the other 

25 advantageous features of the system and method according to the present invention. 
Both wired and wireless links may be used for interconnection to the system and 
method of the present invention, as well as to include various throughput, delay, and 
error rates. The present invention provides flexible radio/television streaming services 
to the local Internet (e.g., multimedia clients which may not necessarily be supported 

30 by the traditional AM/FM or television receivers). The system and method of the 
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present invention also provides the flexibility to the clients to be able to receive 
broadcast from any radio or television station in the world. It offers the capability of a 
hierarchical searching in terms of categories, and a way to insert local advertisements 
during commercial breaks. This will meet the challenge of bringing quality 
5 audio/video broadcast to the people in remote site, and to the wireless mobile clients. 
Radio Antenna Servers are provided in the local domains act as local 
stations/localized servers so as to determine how many people can listen to a 
particular radio/television station globally without a possible degradation of stream 
quality and provides the ability for the local listeners in a single domain to switch 

1 0 between the local program and the global program. These servers also provide the 
ability for the local listeners to receive the local advertisements during commercial 
breaks, while still being tuned to the global program or to continue listening to a 
particular segment of the global program while still being tuned to the local program. 
Another advantageous feature of the present invention is that the system and method 

1 5 allow any server connected to a communications network to be a potential 

broadcaster. The system and method also provides a pricing model which allows the 
servers (and possibly the broadcasters) to obtain a direct financial benefit therefrom. 

As indicated above, the system according to the present invention is 
preferably transport independent, operates over wired and wireless links, and 

20 accommodates the mobility of the client. Therefore, the present invention provides a 
continuity to the listener of a particular program broadcast by the local or global 
station as the mobile client moves. The system and method according to the present 
invention can also utilize a network topology of highly malleable meshes which would 
include more than just static trees where each client (or node) can be mobile. 

25 In an exemplary embodiment of the present invention, a broadcast is 

provided to a receiver via a communication network. The broadcast is received via at 
least one global multicast channel. At least one local multicast channel is associated 
with the global multicast address. A communication link is then established between 
the receiver and the local multicast channel, and the broadcast is routed from the 

30 global multicast channel to the local multicast channel to provide the broadcast to the 
receiver. The number of the receivers which are receiving the broadcast may also be 
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determined. The receiver may include an Internet Protocol (IP) interface which 
enables the receiver to receive the broadcast via an IP-type multicast communication. 
The receiver may also be wireless, and can receive the broadcast in a first subnet using 
a multicast communication. Prior to the receiver moving to a second subnet, a request 
5 is generated by the receiver to receive the broadcast in the second subnet. After 

receiving the request, the broadcast is provided to the wireless receiver in the second 
subnet using the multicast communication. 

The present invention will will now be described by way of detailed 
description of exemplary embodiments thereby with reference to the drawings, in 
10 which: 



BRIEF DESCRIPTION OF THE DRAWINGS 

Figure 1 is a high level functional diagram showing a network based 
broadcasting system which utilizes a conventional unicast communication scheme; 

Figure 2 is a high level function diagram showing a network based 
1 5 broadcasting system of Figure 1 utilizing a conventional multicast communication 
scheme; 

Figure 3 is a functional block diagram showing an exemplary 
embodiment of a system according to the present invention which utilizes the 
multicast communication scheme for transmitting and receiving broadcast streams 
20 between a source and a client. 

Figure 4 is a functional system diagram showing an exemplary 
implementation of the system illustrated in Figure 3; 

Figure 5 is a diagram providing a detailed illustration of the functional 
architecture of another exemplary implementation of the system of Figure 3; 
25 Figure 6A is a functional block diagram showing an exemplary 

embodiment of the Internet-capable broadcast receiving devices according to the 
present invention; 

Figure 6B is a functional block diagram showing an exemplary 
protocol stack, that can be used by the system and method of the present invention; 
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Figure 7 is a flow diagram representing an exemplary embodiment of 
the method according to the present invention; 

Figure 8 is a flow diagram representing another exemplary 
embodiment of the method according to the present invention; 
5 Figure 9 is a schematic system-level functional diagram showing a 

detailed implementation of the system and method according to the present invention 
utilizing particular protocols; 

Figure 10 is a schematic system-level functional diagram showing an 
exemplary scheme in which multicast systems are interconnected via a non-multicast 
10 network; 

Figure 1 1 A is a functional diagram illustrating one embodiment of the 
system and method of the present invention for mobile clients; and 

Figure 1 IB is a functional diagram illustrating another embodiment of 
the system and method of the present invention for the mobile clients. 

15 DETAILED DESCRIPTION 

A. SYSTEM ARCHITECTURE 

An exemplary embodiment of the system according to the present 
invention is shown in Figure 3. The illustrated exemplary embodiment includes four 
functional components, i.e., a Radio Station Client (RSC) 10 or a Primary Station, a 

20 Radio Antenna Server (RAS) 30 or a local station, an Advertisement/Media 

Arrangement (AMA) 40 and at least one Internet Multimedia Client (IMC) 50. It 
should be understood that RSC 10 can be a television station client, and RAS 30 can 
be a television antenna server. IMC 50 can be a car radio or another reception unit 
which is capable of receiving a multicast broadcast. Such car radio may be an 

25 Internet-capable Radio as shall be described in further detail below. In operation, 
RSC 10 (e.g., a computing device with IP interface) transmits a global multimedia 
broadcast via a communications network 20 (e.g., the Internet). RAS 30 (e.g., also a 
server) can receive the global broadcast from the communications network 20, and 
make this broadcast available to IMC 50 using the multicast communication scheme 
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described above with reference to Figure 2 and as shall be described in further detail 
below. In addition, RAS 30 can broadcast a local broadcast to IMC 50, preferably 
also using the multicast communications scheme as shall be described below. AMA 
40 is coupled to RAS 30 so as to insert additional content, indicating advertisements, 
5 into the particular segments of the global broadcast that is received from RSC 10 via 
the communications network 20. AMA 40 can be a separate server with its own 
storage database or a media database which is within RAS 30. IMC 50 can be used to 
receive the global broadcast (which may include additional content inserted by AMA 
40) as well as a local broadcast by RAS 30. 

1 0 An exemplary implementation of the system according to the present 

invention is shown in Figure 4. In this implementation, RSC 10 may include a content 
server 105. The server 105 (via an Internet Protocol communication arrangement 
120) transmits the global broadcast (e.g., the multimedia content) to an arrangement of 
routers 140 which are part of the Internet (i.e., the communications arrangement 20). 

15 These routers 140 deliver the global broadcast to a local station 150 (e.g., part of RAS 
30), which can pass this global broadcast to IMC 50. The multimedia content may 
also be distributed via one or more broadband low earth orbiting satellites 1 1 0 to RAS 
30, via an earth station arrangement 130. As indicated above, the local station 1 50 
can also provide its own local broadcast to IMC 50. The exemplary implementation 

20 shown in Figure 4 preferably utilizes the multicast communication throughout the 
system. However, if particular portions of the system are not capable of using such 
multicast communication, it is possible to utilize an alternate scheme in those 
particular portions as described in greater detail below. It is preferable to implement 
the multicast communication scheme described above with reference to Figures 2 and 

25 4 between RSC 10 and RAS 30 as well as between RAS 30 and each IMC 50. 

Figure 5 shows a detailed illustration of another implementation of the 
system of Figure 3. This illustration and the illustration provided in Figure 2 shall be 
referred to below to explain a particular utilization of the multicast communication 
scheme and how such scheme may be modified in accordance with the system and 

30 method of the present invention. In particular, all RSCs 10 have access to a plurality 
of multicast channels 500 (i.e., addressed at locations Ml to Mi). These addresses 10 
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may be provided in memory or on the hard drive of one of RSCs 10, in a shared 
memory distributed between, or may be located on a storage device remote from 
RSCs 10. The multicast address can also be assigned by a multicast address 
dispersing computer. In addition, all RSCs 10 have access to a global index address 
5 Mx, 

In general, a particular one of RSCs 10 may provide a multimedia 
stream at a particular multicast channel address (e.g., Ml), and then announce to the 
global index address Mx that it has provided the multimedia stream on that particular 
address. As shall be explained in further detail below, the global multicast addresses 
10 are associated with local multicast addresses so that each RAS 40 can forward either 
the global broadcast provided in at least one of the multicast channels 500 (see Figure 
2) broadcast by one or more of RSCs 10, as well as transmit the local broadcast that it 
generates. 

At boot-up time, the clients C0-C9 (i.e, IMCs 50) receive the 

1 5 information associated with the content provided in one or more of the multicast 

channels 500 (preferably by checking a local index address lmx which is associated 
with the global index address Mx as shall be described in further detail below). In 
particular, by checking an address which is associated with the global index address 
Mx, the clients C0-C9 may determine which multimedia stream is currently being 

20 provided in the local channels that are associated, at least in part, with the multicast 

channels Ml -Mi. Then, one or more of RASs 30 may generate the respective requests 
to receive one or more of the global multimedia streams (provided in the channels 
which may be associated with the multicast channels Ml -Mi). It is also possible for 
the clients (i.e., IMCs 50) to receive the addresses of the updated multicast channels 

25 500 from the source (i.e., RSC 10) in real-time or when desired. The requests are 

transmitted upstream to the routers (not shown) which are connected to the respective 
clients (i.e., IMCs 50). 

Provided below is a detailed description of the exemplary components 
of the illustrative system and method according to the present invention described 

30 above, with reference to Figure 5. 
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I. Radio/Television Station Client (RSC)/Primary Station 

As indicated above, RSC 1 0 can be a computing device of any regular 
radio/television station/broadcaster that is capable of transmitting its regular 
programming on an Internet Protocol-based network. It should be understood that 
5 Radio Station Client (RSC) can also be a station client which transmits a television 
type broadcast over the communications network. When RSC 10 broadcasts its 
program over the communications network 20 (e.g., the Internet), such broadcast is 
transmitted to an Internet gateway (not shown in Figure 5) (e.g., a router) located near 
the server's location. Each primary station of RSC 10 (e.g., PS1, PS2 ... PSn as shown 
10 in Figure 5) can preferably transmit its broadcast on an assigned unique multicast 

channel corresponding to a particular multicast address (e.g., Ml, M2... Mi), and the 
respective broadcasted content is provided to this address. As discussed above, the 
assigned multicast address, along with few other relevant parameters, are announced 
to a global multicast address (Mx). 



1 5 II. Antenna Server(RAS)/Local Station 

RASs 30 are generally distributed according to the population, the 
geographic area and/or some other topology. Each RAS 30 preferably offers two 
program tracks to a user of IMC 50 - the global broadcast transmitted by RSC 10 and 
the local broadcast provided by RSC 30. In should be understood that RAS 30 can 

20 transmit/receive televison broadcasts. Since numerous global broadcast can be 

provided on a number of multicast channels, RSC 30 preferably relays at least a subset 
of all transmitted programs in the global broadcast to IMC 50. The broadcast 
transmitted by RSC 10 is generally transmitted globally with gaps in the global 
broadcast so that the local advertisement and/or promotional content can be inserted in 

25 such gaps. The local broadcast may be local news segments provided by RAS 30. 

This scheme according to the present invention provides the user of IMC 50 with an 
ability to receive either the local broadcast or the global broadcast. 

RAS 30 preferably includes a Management Server (MS) 200 and a 
channel database 220. The Management Server 200 creates and/or maintains the 

30 channel database 220, records the statistics regarding the number of IMCs 50 that are 
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receiving a particular broadcast at a particular local multicast channel, provides 
control tools for maintaining and modifying configurable parameters, and manages 
the interface with other devices (e.g., a RTSP server and/or media database, etc.). For 
each RAS 30, the Management Server 200 monitors the global index address Mx, and 
5 receives the global multicast channels Ml, M2 ... Mi (which provide the audio and/or 
video streams) that are described by the global index address Mx. 

These multicast channels are provided in an encrypted form to RAS 30. 
An exemplary scheme to decrypt the encrypted multicast channels at RAS 30 shall be 
described in further detail below. After decrypting one or more of the global multicast 

10 channels M 1 . M2 ... Mi, the stream provided at the address of the decrypted multicast 
channel <c g.. the global channel Ml) is rerouted to a particular local multicast channel 
(e.g., the Iixral channel Im2) that is provided at a corresponding local address. In this 
manner, IMCs 50 can receive the decrypted stream which is provided at the global 
channel Ml to RAS 30 RAS 30 also maintains the directory services, and keeps track 

15 of the IMCs 50 that receive a particular broadcast (i.e., local and/or global). Hence, 
RAS 30 can provide pay-per-listen and/or pay-per-view channels, bill the subscriber 
using the IMCs 50 and manage them. 

III. Advertisement/Media Arrangement (AMA) 

As described above, RAS 30 may include AMA 40, or AMA 40 can be 
20 provided remotely from RAS 30. AMA 40 includes a Local Advertisement Server 
210 (which can be an RTSP server). This Local Advertisement Server 210 is capable 
of playing local media on demand programs (e.g., songs and/or music videos), as well 
as inserting a local advertisement into the global broadcast during a commercial break 
thereof. 

25 IV. Internet Multimedia Client (IMC): 

IMC 50 can be a wired Internet Protocol (IP) device or a wireless IP 
device. For example, IMC 50 can be considered wired when it is connected on a LAN, 
and wireless when it is located remote from the LAN and communicating over a 
wireless communications link. IMC 50 is capable of executing application programs 
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which monitor the local index multicast address lmx where data regarding the global 
or local program are provided. Conventional tools (e.g., NeVot, Vic, vat or any tool 
based on SAP/SDP standards) can be utilized by IMCs 50 to monitor the broadcasts 
and receive the multimedia (e.g., audio and video) streams from the local multicast 
5 channels lml, lm2 ... Imi. Using these tools, IMCs 50 may select any of the broadcasts 
(i.e., local or global) provided by RAS 30 by e.g., viewing the local multicast index 
address lmx on the displays of IMCs 50. 

Once, IMC 50 selects a particular channel, it starts sending an RTCP 
signal and receives the audio and/or video stream over UDP/IP. The protocols 

10 described herein (e.g., RTPC, UDP/IP, etc.) are known in the art, some of which shall 
be described below in a greater detail. After receiving the RTCP signal, the 
Management Server 200 starts monitoring the global multicast address of the global 
multicast channel which provides the broadcast (e.g., the radio program) selected by 
IMC 50. When the broadcast at the selected channel is detected, RAS 30 directs it to 

1 5 the assigned address of the local multicast channels. The Management Server 200 
continues to transmit the broadcast content, and only interrupts the broadcast when 
there are no more IMCs 50 that are receiving and/or requesting this broadcast. 

As shown in Figure 6A, IMC 50 can be a radio having an ability to 
toggle between AM/FM broadcasts and the Internet channels, and/ or a television 

20 which can receive wireless and/or cable broadcasts, as well IP broadcasts. For 

example, it is possible to provide a wireless interface having UDP/IP multicast stack 
which can be connected to a conventional portable radio or a portable television, (or 
utilized independently). Thus, the connection of an conventional radio/television 
receiver to the Internet can be accomplished. As an example, the conventional 

25 radio/television receiver includes a tuner for AM/FM broadcasts and/or for the 

television broadcasts. In addition, this radio/television receiver may include a switch 
(e.g., a mechanical switch, an electrical switch, an automatic software switch, etc.) 
with which the radio/television receiver can be converted to an Internet-ready device. 
Based on the SDP parameters of the program being broadcasted, the tuner of the 

30 Internet-ready device would detect the broadcasts and possibly categorized them (e.g., 
News, Entertainment, etc.). Advantageously, the categories and the available 
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broadcasts are presented on a display screen of such device so that the user can select 
which category /broadcast he or she would like to receive. 

It is also possible to utilize a conventional speech 
generation/recognition system in connection with the Internet-ready device. For 
5 example, the device would provide the available broadcasts/categories to the speech 
generation/recognition system which would then generate voice-type descriptions of 
the broadcasts/categories. Then, the user may vocalize his or her selection, and the 
speech generation/recognition system would determine the selection and provide the 
requested action. 

1 0 B. EXEMPLARY PROTOCOLS AND OPERATION/IMPLEMENTATION 
I. Protocols 

The system and method according to the present invention uses (and 
possibly modifies) the conventional protocols, i.e., SAP (Session Announcement 
Protocol), SDP (Session Description Protocol), RTSP (Real-Time Streaming 

1 5 Protocol), RTP (Real-time Transport Protocol), TCP, UDP, IP and IP Multicast. An 
exemplary protocol stack utilized by the exemplary embodiment of the system and 
method is shown in Figure 6B. The network infrastructure can be wired and/or 
wireless. One exemplary implementation of this infrastructure can operate with 
LMS/MMD wireless links. 

20 Provided below is a short description of the primary protocols that can 

be used by the exemplary embodiment of the system and method of the present 
invention. 

SDP is a Session Description Protocol which is usable for multi-media 
sessions, and can be utilized as a format for a session description (generally does not 

25 incorporate a transport protocol). SDP is intended to be used for different transport 
protocols as appropriate, including SAP, SIP, RTSP, electronic mail using MIME 
extensions, and HTTP. SDP includes the session name and purpose, the time the 
session is alive, the content type (e.g., audio and/or video) comprising the session, 
information to enable reception of those content types (addresses, ports, formats etc.), 

30 the bandwidth to be used by the broadcast, and the contact information for the person 
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responsible for session. SDP is widely used for the multicast sessions over the 
Internet. In order to assist in the advertisement of multicast sessions and to 
communicate relevant session setup information to prospective participants, a 
distributed session directory can be used. An instance of such a session directory 
5 periodically multicast packets containing a description of a multimedia session to a 
multicast address. These signals are subsequently received by potential participants, 
who can use the session description to start the tools required to participate in the 
session Using this protocol, the sender can assign a particular bandwidth for a 
particular application (e.g., radio and/or television broadcast). In this manner, the 

10 more popular or hand width-intensive application (e.g., television news) would use 
more handvtiJth than non-popular application/broadcast. Thus, a popularity-based 
spectrum management can be achieved. 

SAP is an announcement protocol that distributes the session directory 
to the multicast conference sessions. An SDP datagram is part of the payload for SAP. 

15 SAP client which announces a conference session, periodically multicasts an 

announcement packet to a known multicast address and port. The appropriate address 
is determined by the scope mechanisms operating at the sites of the intended 
participants. IP multicast sessions can be either TTL-scoped or administratively 
scoped. Thus, an instance of the session directory may need to listen on multiple 

20 multicast addresses. The announcement contains a session description and optionally 
an authentication header. The session description may be encrypted. It is preferable to 
provide an authentication and integrity of the session announcements to ensure that 
only authorized parties modify session announcements, and to provide the facilities 
for announcing the securely encrypted sessions while providing the relevant proposed 

25 conferees with the means to decrypt the data streams. 

RTSP is a client-server multimedia presentation control protocol 
which is used for an efficient delivery of streamed multimedia over IP networks. It 
utilizes the existing web infrastructure (e.g., inheriting authentication and PICS from 
HTTP). This application level protocol may provide the robust streaming multimedia 

30 in one-to-many applications via unicast and multicast communication arrangements, 
and may support the interoperability between the clients and the servers from different 
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vendors. The process of streaming breaks media streams into many packets sized 
appropriately for the bandwidth available between the client and the server. When the 
client receives enough packets, the user software can be playing one packet, 
decompressing another, and receiving a third. The user can begin listening almost 
5 immediately without the necessity to download the entire media file. RTSP can 

control multiple data delivery sessions, and is capable of providing a way for selecting 
the delivery channels (such as UDP, TCP, IP Multicast) and delivery mechanisms 
based on RTP. RTSP can be used in conjunction with other protocols to set up and 
manage the reserved-bandwidth streaming sessions. 

1 0 RTP is a thin protocol which provides support for applications with 

real-time properties which can be run over UDP. RTP provides a timing 
reconstruction, loss detection, security and content identification. RTP can be used, 
possibly without RTCP, in the unicast or multicast communication arrangements. In 
order to set up an RTP session, the application may define a particular pair of the 

1 5 destination transport addresses (e.g., one network address and a pair of ports for RTP 
and RTCP). In a multimedia session, each medium (e.g., audio, video, etc.) can be 
transported in a separate RTP session with a corresponding RTCP session reporting 
the reception quality. 

RTCP may operate in conjunction with RTP. It provides support for 

20 the real-time conferencing of large groups on the Internet. RTCP control packets are 
periodically transmitted by each participant in an RTP session to all other 
panic i pants. The feedback of the information to the application can be used to control 
the performance and for other diagnostic purposes. RTCP provides the following 
exemplary functions: 

25 Feedback to sending application regarding the quality of the data 

distribution. 

Identification of the RTP source. 
RTCP transmission interval control. 

Communication of the minimal session control information. 
30 SIP has been adopted by the industry, in many cases, as the signaling 

protocol for the Internet conferencing and telephony. SIP is a client-server protocol 
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which provides the mechanisms so that the end systems and the proxy servers can 
provide different required services for setting up a proper signaling scheme. SIP 
creates, modifies and terminates the associations between the Internet systems (e.g., 
conferences and point-to-point calls). SIP is a text-based protocol similar to HTTP 
5 and RTSP, in which the requests are issued by the client, and the responses are 
returned by the server. SIP is independent of the packet layer and only utilizes a 
datagram service, since it provides its own reliability mechanism. This "light-weight" 
protocol is typically used over UDP or TCP, and provides light-weight signaling. SIP 
supports the unicast and multicast communication schemes, as well as combinations 
10 of thereof. It can implement a variety of the conference-related services with a small 
set of handling primitives. 



H. EXEMPLARY IMPLEMENTATION USING THE PROTOCOLS 

The general implementation of an exemplary embodiment the system 
and method according to the present invention has been already described above. An 
1 5 exemplary implementation of the system and method utilizing the above-discussed 
protocols is as follows. 



a. Channel Announcement 

With reference to Figure 5, according to the present invention, a 
particular RSC 10 may send its program live on a unique global multicast channel 

20 (e.g., Ml) globally scoped and encrypted using RTP/UDP. Other RSCs 10 can also 
broadcast their programs on other global multicast channels. Indeed, the multicast 
channel address is different for each broadcast and/or for each RSC 10. These stations 
send their session announcement using a subset of SDP parameters to the global index 
multicast address Mx (which can be encrypted). This common global multicast 

25 address contains a list of the programs that are being broadcasted by RSCs 10 on the 
communication network 20. SDP or a variant thereof can be modified to provide 
IMCs 50 with additional details regarding the streaming being broadcasted. 
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b. Channel Management 

Figure 7 shows a flow diagram representing an exemplary 
implementation of one embodiment of the method according to the present invention. 
In particular, each RAS 30 has a global encryption key which is used by the respective 
5 RAS 30 to monitor the global index multicast address (Mx) to obtain, e.g., the listing 
of the channels and the contents of the channels (step 300). Then, it is determined 
(e.g., using a decryption technique) if RAS 30 can receive some or all global 
broadcasts (step 310). If so, RAS 30 is then provided with an authorization to utilize 
the global broadcast on the global multicast channels Ml ...Mi provided by RSC 10 

10 (step 320). Either automatically or via the manual control, RAS 30 may decide to 
broadcast at least a part of the list to IMCs 50 that are associated with RAS 30. For 
this purpose, RAS 30 may create and/or utilize the channel database 220 which 
contains the list of the supported channels, each with their appropriate attributes, to 
associate the global broadcast channels with the local broadcast channels (step 330). 

15 The subset of channel descriptions announced by each RSC 10 provides sufficient 
data for generating and updating this database 220, which may be a subset of the list 
that is received from the global index multicast address Mx. In this manner, the 
association between the global and local multicast channels can be recorded in the 
channel database 220 (step 340). 

20 Then, it is determined if RAS 30 is also transmitting a local broadcast 

(step 350). If so, RAS 30 transmits its local programs on a specific local multicast 
address lm_l, and records this information in the channel database 220 (step 360). If it 
is determined in step 350 that RAS 30 is not transmitting the local broadcast, the 
process proceeds to step 370, in which RAS 30 either generates and/or modifies the 

25 information in the channel database 220 regarding the broadcasts (e.g., local and/or 
. global broadcasts) which are available for IMC 50. In step 380, RAS 30 sends the 
information provided on the local index multicast address lmx for the announcement 
using SAP to its IMCs 50. RAS 30 also sends the announcement regarding its own 
local programs to the same local index multicast address lmx using SAP. The 

30 announcement on the local index multicast address lmx is preferably not encrypted 
since the RAS 30 prefers all its clients (i.e., the associated IMCs 50) to see what is 
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being broadcasted by it. In an alternative exemplary embodiment of the method of the 
present invention, RAS 30 maintains a pair of multicast addresses for each channel to 
maintain an association between the global multicast channel address (e.g., Ml). 
Using the respective channels, RSC 10 provides its global program on the local 
5 multicast channel address (e.g., Im2) on which the broadcast being is transmitted to 
IMCs 50 by RAS 30 (i.e., steps 330 and 340). 

Figure 8 shows a flow diagram representing yet another exemplary 
embodiment of the method according to the present invention which is executed when 
ihe information in the local index address Imx is provided to IMC 50. In particular, 

10 IMC 50 receives the information in this local index address lmx (step 400). Then, in 
step 4 1 0, IMC 50 may request to receive the broadcast from a particular local 
multicast channel (e.g., Im2). This broadcast can be encrypted or un-encrypted 
depending on the type of a payment model being utilized. Then, RAS 30 determines, 
based on the information regarding the local multicast address being requested by 

1 5 IMC 50, whether the broadcast on the particular channel is local or global (step 420). 
If it is determined that the requested broadcasted is a global broadcast (i.e., originated 
from RSC 1 0), RAS 30 uses the channel database 220 to route the global broadcast 
from the global multicast channel on which the requested broadcast is being 
transmitted to a corresponding local multicast address (step 430), and the process is 

20 directed to step 450. IMC 50 continues transmitting the RTCP packets to the 

Management Server 200 of RAS 30 as long as it receives the global broadcast on the 
particular local multicast channel. It should also be noted that when the Management 
Server 220 receives the global broadcast from RSC 10 on a specified multicast 
address using RTP/UDP, it also periodically exchanges RTCP signals with RSC 10. 

25 If it is determined that the requested broadcast is a local broadcast (i.e., 

originated from RAS 30), RAS 30 provides the local broadcast to IMC 50 on the local 
multicast channel lm_l which is assigned for local broadcasts (step 440). If RAS 30 
indicates that another broadcast (either pre-recorded or live) or an advertisement 
should be inserted into the global or local broadcast (step 450), RAS 30 inserts (or 

30 plays) such broadcast and/or advertisement into the local multicast channel associated 
with the local multicast address of the global or local broadcasts address using, e.g., 
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SETUP and PLAY commands (step 460). For example, the inserted broadcast may be 
either a live news broadcast or a prerecorded news broadcast. Then, RAS 30 provides 
the requested broadcast on the corresponding local multicast broadcast channel (e.g., 
Im2), either with or without the additional content being inserted into the broadcast 
5 (step 470). Thus, for that particular period, a local manager of RAS 30 may decide to 
join such specific global multicast group, this may be done when the local manager 
receives the RTP packets from RSC 1 0, and generates the RTP/RTCP packets for 
IMC 50 on the respective local multicast address. 

c. Using the Protocols 

10 To summarize, IMCs 50 may be Internet Multimedia Clients (e.g., 

personal computers and laptops utilizing wired and/or wireless interconnect, car 
radios/televisions having the IP interface) which monitor the local index multicast 
address lmx to determine what is available. Such monitoring can be performed using 
SAP- and/or SDP-based tools. As described in the SAP specification (which is 

15 incorporated herein by reference) and as known to those having ordinary skill in the 
art, RAS 30 can update the announcement information approximately every few 
minutes. Thus, the program executed at IMC 50 may wait for few minutes before 
seeing the most updated channel information. By using SAP, this lag is either 
substantially reduced, or even eliminated, by a caching scheme. For example, this 

20 caching scheme either executes the SAP receiver of IMC 50 in the background to 

continuously keep its cache current, or moves to 'a local SAP proxy at the startup time 
of IMC 50 and requests a cache download. In the latter case, RAS 30 essentially 
becomes the SAP proxy. 

When IMC 50 makes a request to listen to one of the programs listed in 

25 the program listing (e.g., clicks on the channel), this IMC 50 sends the RTCP signal to 
the local station manager of RAS 30. If there is a broadcast (e.g., a data stream) 
already playing on this local multicast address provided pursuant to a previous request 
from other IMCs 50, then this particular IMC 50 starts receiving the audio and/or 
video stream using RTP/UDP. However, if this is the first request for such broadcast 

30 in this local domain, then RAS joins the multicast tree of the corresponding global 
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multicast address to receive the broadcast from the corresponding RSC 10 which is 
transmitting the requested broadcast. RAS 30 can use a conventional application 
program (e.g., "mlisten") to determine if there is any member which is part of any 
particular multicast group that is currently transmitting broadcasts, and thus should be 
5 able to determine if the request is a first such request for a particular multicast group, 
"mlisten" is a conventional multicast application for monitoring the number of users 
joining a particular multicast group (e.g. receiving information from a particular 
multicast channel). 

d. Local Advertisement Insertion 

10 In accordance with exemplary embodiments of the system and method 

of the present invention, the insertion of advertisement content into the global or local 
broadcast transmitted to IMC 50 is now described below. The system is implemented 
such that RSC 1 0 knows the starting time and the duration of a commercial break 
prior to the transmission of the global broadcast, since it controls the time for such 

15 break. These commercial breaks can also be event driven. Along with the RTP 

packets, RSC 10 continues sending the RTCP packets to the global multicast address 
of the global multicast channel where RASs 30 are monitoring the streams of 
broadcasts. Using the RTCP report, RSC 10 provides the signal to RAS 30 which 
indicates the time and the duration of a break in the broadcast. The term 

20 "advertisement" as used herein includes not only the content directed to selling a 
product or service or to promote the goodwill of a commercial sponsor, but also to 
public service messages and announcements, station break announcements, 
promotions and/or other programming to be broadcasted. 

Upon receiving such signal, the Management Server 200 of RAS 30 

25 requests the local RTSP server 210 (which is part of AMA 40) to start playing the 

local advertisement from a storage medium to a specific local multicast address which 
is associated with the global multicast address at which RSC 10 transmits the global 
broadcast. RAS 30 uses a set of RTSP commands, such as SETUP, PLAY and STOP 
on AMA 40. During this time, the Management Server may stop forwarding the RTP 

30 stream from the global multicast channel to the associated local multicast channel. 
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The local advertisement runs for a time determined by the Management Server 200 
using the information received from the RTCP reports. At the end of the time for the 
commercial break, the Management Server 200 sends a STOP signal to the RTSP 
server 210 so that it stops playing on that particular multicast address. Then, the 
5 Management Server 200 resumes redirecting the audio and/or video streams from the 
global multicast address to the associated local scoped multicast address. Since the 
commercial break times for RASs 30 may overlap, it is possible that the RTSP server 
210 could play several different local advertisements on the different local multicast 
addresses. An illustration of the exemplary implementation described above is shown 
10 in Figure 9. 

One implementation of the system and method for inserting the 
advertisements into the broadcasts is described in greater detail below. In particular, 
the system and method can use "InsertAd.java" commands to insert local 
advertisements. As soon as the broadcast appears on the global multicast channel, it 

15 starts an InsertAd thread which listens for RTCP packets generated by RSC 10 (e.g., 
the RTCP port is one greater than the RTP port).The RTCP packets from RSC 
indicate the number of seconds remaining until the start of the advertisement, as well 
as the length thereof. InsertAd command inserts a local advertisement by switching 
the channel mode to "advertisement". When the global commercial is finished, 

20 InsertAd switches the channel mode back to "redirect". The list of the local 

advertisement files is specified inside a list file which are inserted using, e.g., a Round 
Robin scheduling scheme. 

At startup, RSC 10 initiates RsSendRTCP thread to notify RAS 30 of 
the commercial breaks. The thread sends the RTCP packets so that RAS 30 can insert 

25 local advertisement. The RTCP packets indicate the number of seconds remaining to 
the start of the advertisement, as well as the length of the advertisement. The start 
times of the advertisement are read in the following format (e.g., one record per line): 
day/hour/minute/second/duration; 

day is 1 through 7 which stands for Sunday through Saturday; hour is 0 
30 through 23; minute is 0 through 59; second is 0 through 59; and 

duration is specified in seconds. 
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Since the RTCP packets are transmitted over UDP, there may be a 
possibility of a packet loss or an incorrect order. To address this potential problem, 
the RTCP packets are re-transmitted (e.g., one packet 4 seconds prior to the 
advertisement, next one -3 seconds, next one -2 seconds, etc. with the corresponding 
5 value in the field which indicates the time remaining until the start of the 

commercial). In addition, to allow RAS 30 to distinguish between the re-transmissions 
and advertisements, the RTCP packets have a particular sequence number. All re- 
transmissions have the same sequence number. Each advertisement has a sequence 
number one greater than the previous sequence number. 

e. User Interface for Itemized Content 

It is possible to utilize and/or modify a conventional directory 
structure/user interface referred to as "sdr" in implementing the embodiments of the 
system and method of the present invention. This directory structure/user interface can 
be used as a tuning mechanism for the wireless IP radios and/or IP television, and may 
be touch-tone based, voice activated, etc. This "sdr" structure/program (created by 
ISI, Meriana del Ray, CA) can be modified or extended to make it more customized 
and searchable for searching purposes. For example, "sdr" can be modified to 
categorize the content of the streaming media according to the type of program being 
broadcasted (e.g., "game show", "news", etc.) In addition, it is possible to utilize a 
voice activated-type "sdr" according to the content type, as well as to provide a menu 
for a particular locality. Also, with a touch of a button or by pronouncing a particular 
word (e.g., "News"), sdr would provide a visual menu or a voice menu to indicate 
which channels are available to that particular locality. With another touch tone or 
voice activation, sdr may provide IMC 50 with access to the broadcast from the local 
multicast channel. Other features need not be further discussed, since they would be 
clearly understood to one having ordinary skill in the art. 

f. Payment Model 

There are numerous payment models that can be supported by the 
system and method according to the present invention. For example, RAS 30 may 
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collect the fees from the local advertisement sponsors for broadcasting their 
advertisements during the commercial breaks while relaying the global or local station 
broadcasts. In addition, RAS 30 may also relay some pay-per-listen and/or pay-per- 
view programs. In this case, RAS 30 pays the global station (i.e., RSC 10) a fee which 
5 depends on how many listeners/viewers are listening to or viewing a particular 

program. The number of listeners/viewers can be determined from the RTCP reports 
that are generated from IMCs 50. Every RAS 30 can also broadcast its local program 
to IMCs 50 with the segments of the news or some other premium programs relayed 
from RSCs 10 

10 A different type of the pricing model can also be provided to reflect the 

process of determining when and on which channels the advertisers should place their 
advertisements in order to maximize their return on investment. Priorities can be 
assigned to cerum advertisements so as to enable the advertisers to compete for a 
higher time slot or timing of the advertisement (e.g., the highest paying company 

15 would get the slot during the Super Bowl by using a contention algorithm). It may also 
be possible to implement the exemplary payment schemes, e.g., public financing, 
advertising and on-air solicitations for donations. Hybrid models (e.g., the paying 
customers are not required to view or listen to commercial or receive solicitations for 
donations) are also feasible. Furthermore, another embodiment of the payment model 

20 can be associated with the security model described below. 

r. Security 

It is possible to provide at least four levels of encryption for the system 
and method according to the present invention (e.g., a global announcement 
encryption, a global multicast stream encryption, a local audit encryption and a user 
25 authentication). 

Utilizing the global announcement encryption, it is possible to separate 
the global announcements from the local announcements. IMCs 50 should not be able 
to gain access to the global announcements, and would only be able to view the local 
announcements. With the global encryption key during the announcement (by RSCs 
30 10), IMCs 50 would not be allowed to find out about available the global channels, 
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and thus such scheme provides a control over to RSC 10 to announce only a subset of 
these channels to IMCs 50 via RASs 30. However, if some stations do not want to 
encrypt their contents and session announcements at all, this security model should 
effectively prevent IMCs 50, as well as the nonpaying RASs 30, from receiving the 
5 broadcast from those designated stations. Thus, each RSC 10 should maintain a secret 
key, and encrypt all outgoing content so that only a ciphertext stream is transmitted. In 
particular, the concept is to generate a symmetric encryption key at RSC 10, and 
securely distribute this key to a particular RAS 30 upon payment of the required fee. 
There are many ways this key can be distributed to the local stations, as is known to 

1 0 those having ordinary skill in the art. 

The global multicast stream encryption can be extended to RAS 30 as a 
second level hierarchy. Some of the pay-per-listen and/or pay-per-view programs can 
be announced to the local multi-cast addresses in any domain using the encryption key 
so that an appropriate fee collection procedure can be established for the IMCs 50. 

1 5 Any type of encryption can be applied to the audit data of RAS 30, so as to preserve 
the sensitive information such as the secret keys of RSCs 10, the information for the 
pay-per-listen and/or pay-per-view channels, the user accounts, and the payment data. 
The advertising entities can be authenticated so that unauthorized companies could 
not gain access to AM A 40. 

20 . In practice, each RAS 30 generates its own Public Key /Private Key 

pair. Each RSC 10 generates an SEK key, and begins transmitting the encrypted audio 
and/or video content. This SEK key should be distributed to the participating RASs 30 
in a secure way so that other RASs 30 (which did not pay) cannot obtain this key. As 
such, the Public Key technology is employed for this purpose. RAS 30 submits the 

25 Public Key to RSC 10 along with its payment. Then, RAS 30 receives an Integer ID 
from RSC 10 which is later used to index the SEK distribution list. RSC 10 collects 
the Public Keys from RAS 30 and adds these keys to its SEK distribution list upon 
their payment. 
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h. Logging Mechanism 

One of the purposes of providing a logging mechanism for the system 
and method of the present inventions is to provide a process for the advertisers to 
determine when and on which channels to place their advertisements so as to 
5 maximize their returns on investment. RTCP is well suited for allowing RAS 30 to 
collect user-specific and channel-specific listening information. In one embodiment, 
RAS 30 constantly monitors the number of users receiving the broadcast on each 
channel, as well as the type of content being transmitted (i.e., the advertisements as 
opposed to the real content). This is especially advantageous for payment purposes by 

10 the advertiser to the local station when the users join or leave the local multicast group 
at the time when the advertisement starts/stops playing. When RAS 30 detects an 
"audience change " (i.e., a change in the number of listeners or the type of content), it 
encapsulates this information into a particular structure, and passes it to the separate 
logging thread for storing into the log files. The logging thread in turn, buffers this 

1 5 information and periodically writes out the contents of the buffer, in a binary format, 
to the log files (using a java serialization). 

The above-described features - i.e., separate logging thread, output 
buffering, and binary (as opposed to text) logs - enable a quick output to avoid an 
interference with the quality of the audio and/or video transmission at run-time. In 

20 addition, these features allow for a good scalability as the number of the receivers of 
the broadcasts increase. A report generation tool can also be used to inspect the log 
files, and generate the statistics in a format that can be presented to the user. Such tool 
may support various commands, such as line options that control the way the tool 
interprets the log and presents its contents to the user. 

25 C. NON-MULTICAST ENABLED NETWORK 

The multicasting environment can be implemented for all segments 
within the system and method of the present invention. Although it may be simpler to 
implement the multicast communication in the Intranet or within an autonomous 
system (e.g., a separate domain), in the past the multicast support between the 
30 autonomous systems has not been readily available. To extend the above-described 
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functionality to a network where the multicast communication is not supported, it may 
be preferable to provide another embodiment of the system and method according to 
the present invention which is based on the user level or the network level application 
level. 

5 I. Multicast Tunneling - Network Layer Solution 

If there is a lack of the multicast connectivity between some portions of 
the network, the multicast connectivity can still be used by establishing a multicast 
tunnel between two different networks using the edge routers. In order to establish the 
multicast tunnel, it is preferable to provide at least one server running a multicast 
10 routing daemon in each such network. However, since this approach is a network layer 
solution, it ma> also be preferable if some of the hosts would be running the multicast 
routing daemon. This approach may also assume that there is a mutual understanding 
(i.e., intcrconnectivitv) between several connectivity providers. 

II. l T DP servers - User Level Solution 

15 It may be easier to implement the multicast communication within the 

Intranet. Since the multicast communication is not yet widely deployed over the wide 
area network (i.e., some of the intermediate routers may not support the multicast 
communication), the multicast connectivity between portions of these autonomous 
systems may not currently exist. Figure 10 shows an exemplary configuration where 

20 there is no multicast connectivity in the wide area network, but the multicast 
communication is enabled within the local area. Thus, there may be islands of 
multicast enabled networks, but there may not be any multicast connectivity between 
the islands. In this exemplary configuration, a UDP Server 550 is provided. This UDP 
Server 550 is co-located with RAS 30. It is also possible that its functionality is 

25 provided in the Management Server 200. This UDP server 550 can use a modified 

version of "rtptrans" which allows a conversion of the audio and/or video stream from 
the multicast network type to the unicast network type, and vice- versa, "rtptrans" is a 
conventional RTP translator application which copies RTP packets from any number 
of unicast and multicast addresses. Alternatively these servers can use "UDP Multicast 
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Tunneling Protocol" (UMTP) which can set up a connection between the multicast 
enabled islands by tunneling multicast UDP datagrams inside unicast UDP datagrams. 

In particular, whenever any radio station wants to announce its program 
to the Internet, or if any system wants to broadcast content to the Internet, these 
5 devices register with the nearest antenna server. This can be done as described above, 
where each broadcaster will send its announcement on a specific multicast address in 
the local domain, and RAS 30 will receive the announcement through SAP. Each 
RAS 30 is responsible for maintaining a database of the program profile of the set of 
radio stations announcing in the same domain. If there is no multicast connectivity 
1 0 between antenna servers over the wide area network, then RASs 30 would update each 
other's program schedules which can be categorized according to, e.g., the News type. 
Thus, al any point in time, each RAS 30 will have the program schedule of all RSCs 
10 broadcasting globally, in addition to its own local program if RAS 30 is 
broadcasting the local program. 

1 5 III. Utilization of UDP Multicast Tunneling Protocol (UMTP) 

In order to extend this multicast connectivity to all the autonomous 
systems, LTDP servers that execute the convention UDP Multicast Tunneling 
Protocol can be implemented for a use with the system and method according to the 
present invention. For example, the UDP Multicast Tunneling Protocol establishes a 

20 connection between two end-UDP servers by tunneling the multicast UDP datagrams 
of the respective domain inside unicast UDP datagrams. Each UDP server is located 
within the autonomous system and that autonomous system is multicast capable. In 
this case, both the end points of the tunnel act as masters. Whenever a tunnel endpoint 
- whether a master or slave - receives a multicast UDP datagram addressed to a, e.g., 

25 group, port, etc., that is currently being tunneled, it encapsulates this datagram, and 
sends it as a unicast datagram to the other end of the tunnel. Conversely, whenever a 
tunnel end-point receives, over the tunnel, an encapsulated multicast datagram for a 
group or port of interest, it decapsulates it and resends it as the multicast datagram. 

Each UDP server in an autonomous domain listens to the local 

30 common multicast address to find out the announcement within its domain, and passes 
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it to the other UDP servers in other domain within an encapsulation. Another UDP 
server, after receiving the local multicast address, decapsulates and announces it on 
the local multicast address in the other domain. These UDP servers keep listening to 
each other periodically to update the announcement status. Thus, at any particular 
5 point in time, each client knows the program status of several programs that are 
playing within various domain. If a client prefers to listen to a particular program 
playing in a different domain, it makes a request on the local common announcement 
bus. The local UDP server receives the request, and passes this request to the 
corresponding UDP server in the proper domain. The remote UDP server sends the 
1 0 encapsulated stream on a unicast address, and the local UDP server sends it on the 
appropriate multicast address in the local domain. It is preferable if there is no 
overlapping of the multicast addresses with those provided in a different zone (e.g., a 
zone provided remote from the zone which provide the information on the multicast 
channel). 

15 IV. RTP Trans 

It is also possible to provide an RTPTrans server which converts the 
multicast stream to the unicast stream, and vice versa. A dedicated RTPTrans server 
can be provided in each area. Alternatively, the RTPTrans server can be a part of RAS 
30. For example, the RSCs 10 in the local area transmit programs to the specified 

20 multicast addresses, and send their announcements to the common multicast address. 
The local RTPTrans server listens to these announcements, and send them to other 
RTPTrans servers located in different areas, where the announcements are transmitted 
to the common multicast announcement address in that specific area. Thus, when RAS 
30 listens to the common multicast address using SAP, it can obtain the program 

25 listing of RSCs 10 in other areas, in addition to the listing in its own area. The 

RTPtrans server receives the unicast audio and/or video stream from each RSC 10 via 
other RTPtrans server, and multicasts it on a specific multicast address corresponding 
to the remote radio station. 
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D. MOBILITY MANAGEMENT 

Another embodiment of the system and method according to the 
present invention provides a Mobility Management (MM) technique. This technique is 
especially preferable when IMCs 50 are mobile and wireless. Thus, e.g., area 1 may be 
5 covered by one RAS 30 provided one subnet, and area 2 may be covered by a second 
RAS 30 provided on another subnet. As the mobile and wireless IMC 50 moves from 
area 1 to area 2, it is essential for the mobile IMC 50 to continue receiving (i.e., 
without significant interruptions) the broadcast it was receiving from RAS 30 
covering area 1 . As shall be described in further detail below, one way to accomplish 

10 such uninterrupted broadcast is to imitate the streaming of the broadcast that the 

mobile IMC 50 has been receiving in area 1 into area 2. RAS 30 in area 2 should have 
adequate information about the mobile IMC 50 traveling into area 2 so that it can now 
begin streaming with virtually no perceived discontinuity in the broadcast to the 
mobile IMC 50. Provided below is a description of possible approaches to address the 

15 triggering of the multicast streaming in the wireless environment when the mobile 
IMC 50 moves from one subnet to another. 

As described above, each RAS 30 may have two interfaces having 
respective addresses, one can be a global address and other maybe a local address. It 
is also possible to utilize one interface for both address configurations. As shown; in 

20 Figures 1 1 A and 1 IB, symbols la, lb, Ic represent globally known subnets (e.g., 

globally addressable subnets) connected to one of the interfaces of respective RAS 30, 
while symbols ia, ib, ic represent the local subnets (or cells) connected to the 
secondary interfaces of RAS 30, and could be local to that particular area.. 

In operation, RAS 30 receives the multicast stream through its global 

25 interface and redirects it out through the local interface for IMC 50 in each cell. In the 
exemplary implementation shown in Figures 1 1 A and 1 IB, symbols SI, S2 ... S5 
represent servers (or RASs 30) which are connected to upstream routers. Each server 
(with the exception of S2 and S3 which are connected to the same subnet via a 
multicast switch) is connected to a different subnet, and to a separate interface. Each 

30 server is assigned to one particular cellular region, which can be a part of a private 
subnet dedicated for the local user. The base stations are not shown in Figures 1 1 A 



BNSDOCID: <WO 0079734A1_I_> 



WO 00/79734 



PCT/US00/16913 



33 

and 1 IB for the sake of simplicity of the depiction. These base stations can be IP 
based. It is also possible for the servers to behave as the base stations on one of its 
local interfaces (e.g. having dual interfaces). It is also possible to connect the second 
interface of the server to a non-IP based base station (e.g., a layer-2 base station), 
5 which would perform the handoff. In the illustrated implementation, the servers S2 
and S3 are connected to a multicast switch, which then becomes a part of the same 
subnet that can manage the traffic using GSMP. GSMP is a General Switch 
Management Protocol which can be used in multicast transmissions at a switch level. 
Using GSMP, is possible to save the bandwidth of an adjacent cell if both cells are 
1 0 part of the same subnet. Different exemplary schemes to effectuate the handoff of the 
broadcast when the mobile IMC 50 moves from area 1 to area 2 (i.e., from subnet S3 
to subnet S4) shall be described in further detail below. 

I. Post-Registration 

The post-registration approach is the easiest approach. However, it 

1 5 may take a long time for the same multicast stream to be directed in the new cell. In an 
exemplary scenario, the mobile IMC 50 move to a new cell (i.e. from cell ib to cell 
ic), obtains the new IP address if it is moving to a new subnet, and then sends the join 
query via RTCP or IGMP scheme. In this case, there may still be a latency during 
hand-off. This latency can be avoided by other schemes described below. 

20 Popularity based spectrum management to address the limits of 

spectrum, e.g., a control mechanism to manage an audio/video stream based on a 
popularity of the program. 

In an implementation of an exemplary embodiment of the system and 
method according to the present invention, the mobile IMC 50 moves to an adjacent 

25 cell (i.e., from cell ib to ic), obtains a new IP address via a multicast address dispenser 
server if it is moving to a new subnet, and sends a "join" message via RTCP or IGMP 
scheme. After the handover, the mobile IMC 50 would continue to receive the 
multicast streaming content in the new subnet if there are other active participants in 
that adjacent cell receiving the content which the mobile IMC 50 wants to receive. If 

30 there is no participants which receive a particular streaming content in the adjacent 
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subnet into which the mobile IMC 50 moves into, then the mobile IMC 50 joins the 
group by itself after receiving the query from the "first-hop" router (e.g., the router to 
which the mobile IMC 50 is directly connected to). 

It takes some time for the mobile IMC 50 to configure itself after the 
5 move, and then join the group. For example, the mobile IMC 50 may wait for 70-75 
seconds to receive the multicast traffic it was previously receiving after a handover. It 
is also possible to use a discovery agent to discover that the mobile IMC 50 has 
moved to another subnet (i.e., the mobile IMC 50 received a new address). This 
determination may triggers the above-described joining scenario. 

1 0 Advantageously, the above-described handover timing can be reduced 

by exploiting a fast reconfiguration and join time using RTCP (via application layer 
triggering). For example, if the adjacent cell is not a new subnet , then the mobile IMC 
50 does not need to be reconfigured. Indeed, the mobile IMC 50 retains its IP address, 
and the triggering procedure can still be activated using RTCP by utilizing a variation 

1 5 of GSMP. Otherwise, the streaming content would already be flowing in the adjacent 
cell via the multicast communication technique. 

II. Pre-Registration 

Each station (e.g., the servers SI, S2 ... S5) can have multiple 
neighboring stations (i.e., also servers). For each of these station being shared with 

20 another station, it is preferable to issue a multicast announcement (e.g., a multicast 

address), where each station can determine the program subscribed to, e.g., the group 
address used by the mobile IMC 50. Just before IMC 50 leaves (or decides to leave) 
the current cell (a determination which could be based on the threshold value of the 
received signal), this IMC 50 sends an RTCP message to the local server. The local 

25 server then announces this RTCP message to the sharing multicast addresses, where 
the neighboring stations would be listening to in the global space. The neighboring 
stations (e.g., servers) connect to the multicast address, and verify it with the 
information in their own database to determine if this stream has already been 
transmitted (e.g., if the particular group has already been subscribed to). If another 

30 client have been listening to the same stream, then nothing is done. If the broadcast is 
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not being transmitted, then RAS 30 sends an IGMP message to the upstream router, 
and passes the stream to the local cells using a local multicast address, even before the 
mobile IMC 50 moves to the new cell. Thus, a soft hand-off is emulated for the 
associated stream. As soon as the mobile IMC 50 moves to the next cell, it can still 
5 receive the same stream without any interruption. The mobile IMC 50 sends an RTCP 
BYE message to the server as it move away from the previous server. 

HI. Pre-Registration with Multicast Agent 

In this scheme, a multicast agent is utilized to take care of the multicast 
stream. The multicast agent can be provided within each router, which sends these 

1 0 streams to the respective global multicast addresses (e.g., for the area where these 
clients are trying to move in) in each subnet for a specific period of time, as 
determined by a timer associated with the subnet. Thus, each neighboring server 
receives the stream irrespective of whether the mobile IMC 50 is moving into that cell 
or not. As soon as the mobile IMC 50 moves into the new cell, it sends an RTCP 

15 signal to alert that the mobile IMC 50 has moved in, thus the timer does not need to be 
triggered. 

IV. During Registration 

In another scheme according to the present invention, this information 
can be passed on, as a part of a registration method. When the mobile IMC 50 moves 

20 in and attempts to acquire the address in the local subnet, it can send the request for 
that stream in its DHCP option regarding the address it has been listening to. 
However, in that case, the server may also be a registration server. Thus, at the time 
of obtaining the IP address from the DHCP server, the mobile IMC 50 can send the 
local multicast address to the server, and depending on whether the server is already a 

25 part of the multicast tree, it would ignore this request or re-join the tree. 

V. Proxy Registration 

Another scheme can deploy a proxy agent in each subnet. These proxy 
agents join the upstream multicast tree on behalf of the servers, even before the 
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mobile IMC 50 moves into the cell. The neighboring proxy server would then listen to 
a common multicast address to determine the impending host's subscribed multicast 
address. 

The foregoing describes exemplary embodiments of the present 
5 invention. Various modifications and alterations to the described embodiments will 
be apparent to those skilled in the art in view of the teachings herein. For example, 
the system and method according to the present invention can also be used for either 
wired or wireless teleconferencing over the Internet using at least in part the multicast 
communication technique. It will thus be appreciated that those skilled in the art will 
10 be able to devise numerous systems and methods which, although not explicitly 

shown or described herein, embody the principles of the present invention, and are 
thus within the spirit and scope of the present invention. 
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CLAIMS 

1 . A method for providing a broadcast of content to a receiver via a 
communication network, comprising the steps of: 

a) receiving the broadcast on at least one global multicast channel; 
5 b) associating at least one local multicast channel with the at least one 

global multicast channel; 

c) connecting the receiver to the at least one local multicast channel; and 

d) routing the broadcast from the at least one global multicast channel to 
the at least one local multicast channel to provide the broadcast to the receiver. 

10 2. The method according to claim 1, further comprising the step of: 

e) receiving a request from the receiver to receive the broadcast. 

3. The method according to claim 1, further comprising the steps of: 

f) inserting the broadcast into the at least one global multicast channel; 

and 

1 5 g) transmitting the broadcast at the at least one global multicast channel 

from a global server to a local server. 

4. The method according to claim 3, 

wherein the at least one global multicast channel is a plurality of global 
multicast channels, and the at least one local multicast channel is a plurality of local 
20 multicast channels, 

wherein the broadcast is inserted into a first global channel of the global 
multicast channels, 

wherein the first global channel is associated with a first local channel of the 
local multicast channels, and 
25 wherein the receiver receives the broadcast from the first global channel on the 

first local channel. 
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5. The method according to claim 4, wherein the broadcast is inserted into the 
first global channel by the global server, and wherein the global multicast channels are 
received by the local server. 

6. The method according to claim 5, further comprising the steps of: 

h) at the global server, inserting a further broadcast of content into a 
second global channel of the global multicast channels; 

i) receiving a request from the receiver to receive the further broadcast 
from the local server; 

j) if the second global channel is not available to the local server, 
obtaining access for the local server to the second global channel; 

k) after step (i), associating the second global channel with a second local 
channel of the local multicast channels; and 

1) providing the further broadcast to the receiver by connecting the 
receiver to the second local channel and routing the further broadcast from the second 
global channel to the second local channel. 

7. The method according to claim 1 , 
wherein the at least one global multicast channel is a plurality of global 

multicast channels, 

wherein the at least one local multicast channel is a plurality of local multicast 
20 channels, 

wherein the broadcast is inserted into a particular global channel by a global 
broadcasting device, and 

wherein the broadcast from the global multicast channels are received by a 
local broadcasting device. 

25 8. The method according to claim 7, further comprising the steps of: 

m) inserting a local broadcast into a particular local channel of the local 
multicast channels, the local broadcast being different from the inserted broadcast; 
and 



10 
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n) if the receiver issues a request to receive the local broadcast, 
establishing a communication link for the receiver to the particular local channel to 
receive the local broadcast. 

9. The method according to claim 1 , further comprising the step of: 

5 o) at a predetermined time and using a multicast communication, 

determining a number of receivers which are receiving the broadcast. 

1 0. The method according to claim 1 , wherein the receiver includes an Internet 
Protocol (IP) interface which enables the receiver to receive the broadcast via an IP- 
type multicast communication. 

10 11. The method according to claim 1, wherein the receiver is wireless, and 

receives the broadcast in a first subnet using a multicast communication, and further 

comprising the steps of: 

p) receiving, from the receiver moving from the first subnet to a second 

subnet, a request to receive the broadcast in the second subnet; and 
15 q) after receiving the request from the receiver, providing the broadcast to 

the wireless receiver in the second subnet using the multicast communication. 

12. The method according to claim 1 1, further comprising the step of: 

r) stopping a transmission of the broadcast in the first subnet after 
receiving the request from the receiver. 

20 13. The method according to claim 1 , wherein normal content of the broadcast has 
at least one break of respective predetermined duration, and further comprising the 
steps of: 

s) inserting respective predefined content data into the at least one break 
in the normal content of the broadcast; and 
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t) providing the broadcast to the receiver after the respective predefined 
content data is inserted into the at least one break of the normal content of the 
broadcast. 

14. The method according to claim 13, wherein the predefined content includes at 
5 least one of an advertisement, a station break announcement, a promotion and other 

pre-recorded content. 

1 5. The method according to claim 8, wherein the local broadcast has at least one 
break at a respective time and of a respective duration, and further comprising the 
steps of 

10 u) inserting respective predefined content into the local broadcast during 

the at least one break in the normal content of the local broadcast; and 

v > pro\ iding the local broadcast to the receiver after the respective 
predefined content of the local broadcast is inserted into the at least one break of the 
normal content of the local broadcast. 

15 16. The method according to claim 1 3, wherein the particular data includes at least 
one of an advertisement, a station break announcement, a promotion and pre-recorded 
content for global broadcast. 

17. A method for providing a respective predefined content to a receiver during a 

real-time broadcast of normal content, comprising the steps of: 
20 - receiving the real-time broadcast of normal content from a remote 

device via a multicast communication, the real-time broadcast including information 

indicative of a respective time and a duration' of at least one break in the broadcast of 

the normal content; 

inserting the respective predefined content into the real-time broadcast 
25 during the at least one break in the normal content; and 
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providing the real-time broadcast to the receiver after the respective 
predefined content have been inserted into the at least one break in the normal content 
of the real-time broadcast. 

18. The method according to claim 17, wherein the respective predefined content 
5 includes at least one of an advertisement, a station break announcement, a promotion 

and other pre-recorded content for global broadcast. 

19. The method according to claim 17, wherein the real-time broadcast is received 
on at least one global multicast channel, and further comprising the steps of: 

associating at least one local multicast channel with the at least one 
1 0 global multicast channel; and 

establishing a network link between the receiver and the at least one 
local multicast channel, and wherein the real-time broadcast is provided to the 
receiver by routing the real-time broadcast from the at least one global multicast 
channel to the at least one local multicast channel. 

1 5 20. The method according to claim 1 7, wherein the receiver is wireless and 

receives the real-time broadcast in a first subnet using a multicast communication, and 

further comprising the steps of: 

receiving, from the receiver moving from the first subnet to a second 

subnet, a request to receive the real-time broadcast in the second subnet; and 
20 - after receiving the request from the receiver, providing the real-time 

broadcast to the wireless receiver in the second subnet using the multicast 

communication. 

21. The method according to claim 17, wherein the receiver includes an Internet 
Protocol (IP) interface which enables the receiver to receive the real-time broadcast 
25 via an IP-type multicast communication. 
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22. A method for providing and maintaining a real-time broadcast to a wireless 
receiver on a communications network, comprising the steps of: 

providing the real-time broadcast into the receiver in a first subnet using a 
multicast communication; 
5 receiving from the wireless receiver, moving from the first subnet to a second 

subnet, a request to receive the real-time broadcast in the second subnet; and 

after receiving the request from the wireless receiver, providing the real-time 
broadcast to the wireless receiver in the second subnet using the multicast 
communication. 

10 23. The method according to claim 22, further comprising the step of: 

stopping a transmission of the real-time broadcast in the first subnet 
after receiving the request from the receiver. 

24. The method according to claim 22, wherein the wireless receiver includes an 
Internet Protocol (IP) interface which enables the receiver to receive the real-time 

1 5 broadcast via an IP-type multicast communication. 

25. The method according to claim 22, wherein the real-time broadcast is received 
on at least one global multicast channel, and further comprising the steps of: 

associating at least one local multicast channel with the at least one 
global multicast channel; and 
20 - establishing communication to the wireless receiver over the at least 

one local multicast channel, and wherein the real-time broadcast is provided to the 
wireless receiver by routing the real-time broadcast from the at least one global 
multicast channel to the at least one local multicast channel. 

26. The method according to claim 22, wherein normal content of the real-time 
25 broadcast has at least one break at a respective time and for a respective duration, and 

further comprising the steps of: 
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inserting respective predefined content into the real-time broadcast during the 
at least one break in the normal content; and 

providing the real-time broadcast to the wireless receiver after the respective 
predefined content is inserted into the real-time broadcast during the at least one break 
5 in the normal content. 



27. A receiver, comprising: 

a tuner receiving at least one of a radio broadcast and a television 

broadcast; and 

an Internet Protocol-type communication device configured to receive 
10 a real-time Internet Protocol broadcast via a multicast communication, the analog 
tuner being coupled to the Internet Protocol-type communication device. 

28. The receiver according to claim 27, further comprising: 

a switching device coupled between the Internet Protocol-type 
communication device and the tuner, the switching device being switchable between a 
1 5 first state and a second state, the first state enabling the tuner to receive broadcast 

signals, the second state enabling the Internet Protocol-type communication device to 
receive Internet Protocol type data using the multicast communication. 

29. The receiver according to claim 27, wherein the Internet Protocol-type 
communication device is connected to at least one local multicast channel for 

20 receiving the real-time broadcast from a global multicast channel. 

30. The receiver according to claim 27, 

wherein the receiver is wireless, and the Internet Protocol-type communication 
device receives the real-time broadcast in a first subnet using the multicast 
communication, 

25 wherein, prior to the wireless receiver moving from the first subnet to a second 

subnet, the Internet Protocol-type communication device transmits a request to receive 
the real-time broadcast in the second subnet; and 
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wherein, after transmitting the request, the Internet Protocol-type 
communication device receives the real-time broadcast in the second subnet by 
utilizing the multicast communication. 

31. A method for monitoring a number of receivers that receive a broadcast via a 
5 communication network, comprising the steps of: 

providing the broadcast to at least one of the receivers on at least one local 
multicast channel; and 

at a predetermined time and using a multicast communication, explain how the 
number of the receivers which are receiving the broadcast the number being 
10 determined by receiving information from the receivers indicative of the broadcast 
being received by the receiving. 

32. A device for providing a broadcast of content to a receiver via a 
communication network, comprising the steps of: 

a communication device communicating with at least one global 
1 5 multicast channel to receive the broadcast; 

at least one local multicast channel; and 

a processing device associating the at least one local multicast channel 
with the at least one global multicast channel, and routing the broadcast from the at 
least one global multicast channel to the at least one local multicast channel to provide 
20 the broadcast to the receiver. 
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tinclude csys/socket .h> 
tinclude <stdio.h> 
tinclude <netinet/in.h> 
tinclude <unistd.h> 
tinclude <string.h> 
tinclude <netJ±£.h> 
tinclude <fcntl.h> 
•include <stropts.h> 
tinclude <pthread.h> 
#include <sched.h> 
tinclude <stdiib.h> 
tinclude <limits.h> 
tinclude -RAS.h" 



sxtecn uint32_L randora32(int type); 

int tot al_ threads » 0; 

int current_state - inclex » -1; 

State * state_array; 

int server port, raulticast_port; 

int connfd; 



main (int argc, char **argv) 
( 

int listenfd, fd; 
int i, n; 

struct sockaddr_in servaddr, cliaddr; 
int len - sizeof (cliaddr) ; 
RequestPkt *rp; 

char buffer[sizeof (RequestPkt] + MAX_FILENAKB] ; 
int 3ta.te_in.dexj 

if (argc < 3> { 

printf ("usage:- RAS <RAS port> <multicaat port>\n"); 
exit(l); 

} 

argv++; 

server_port - atoi(*argv); 
argv++; 

multicast. port = atol(*argv) ; 

atate_array - (State *) roalloc (sizeof (State! * KAX_STATES); 
for (i-0; i <MAX ta _STATES % { 
state_array li] .valid - FAl.SE/ 

> 

listenfd - socket (AF_INET, SOCK_5TR£AM. 0) ; 
if (liatenfd < 0) { 

perror ("aocJcet">; 

exit (1); 

) 

bzero (iservaddr, sizeof (servaddr)); 
servaddr .s in_ family - AF_INETy 
servaddr. a in_addr.s_addr - htonl (INAODR^ANY) ? 
servaddr . sin_port - server_part; 

if (bind (listenfd, (struct sackaddr *) & servaddr , aiieof (oervaddr)) < 0) < 

f 5 ?£>95l2>ZTl U 5 
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perror ("bind"); 
exit(l); 

) 

if (listen (listenfd, 1024) < 0) ( 
perror ("listen"); 
exit(l); 

) 

connfd - accept (listenfd, (struct sockaddr *) tcliaddr, &len); 
if (connfd < 0) { 

perror ("accept"); 

exit (1) ; 

) 

rp « (RequestPkt *) buffer; 

while (TRUE) ( 

printf (" \n") ; 

if { (n - read (connfd, rp, MAX_REQUEST_LENGTH) ) <» 0) ( 
perror ("read"); 

for (i - 0; i <» current_state_index; i++) ( 
if istate.array I i ] . valid) ( 
stop(i) ; 

> 

exit(l); '* 

) 

// if <n — 0) continue; 

ford - 0; i < 12; i++) { 
printf ("%x\n", buffer (i) ) ; 

} 

printf ("RAS: main: rt*_addr=%x, lra_addr=%x\n" , (uint32_ t) rp->«L_addr, 
(uint32_t) rp->lrtL_addr) ; 



state_index » f indLM(rp->lm_addr) ; 

switch (rp->request_type) { 

case PLAY: 

printf <"PLAY\n"> ; 

sendStatus (play <state_index, rp->m^addr, rp->lnL_addr) ) ; 
break; 

case COMMERCIAL: 
printf <"COMH\n w ) ; 

printf ("stat e_index-%d, path_length-%d, path-%s\n», 
state_index, rp->path_length, rp->path) ; 

sendStatus (commercial (state_index, rp->path_length # rp->patfa) ) ; 
break; 

case LOCAL_PLAY: 

printf ("LOCAL PLAYNn" ) ; 

printf < "pat h_length-%d, path-%s\n", 
rp->path_length r rp->path) ; 
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sendStatus (localPlay <rp->lm_addr, rp->path_length, rp->patn) ); 
break; 

case STOP: 

print* rSTOP\n") ; 

if (state_index < 0) sendStatus (ERROR) ; 
else stop (state. index) ; 
sendStatus (OK) ; 
break; 

default : 

print f ( * ERROR \ n w ) ; 
sendStatus (ERROR) ; 

> 

Lnt f indNewIndex ( ) 
{ 

int i; 

printf ("f indNewIndex () : tot al_t reads=%d r current. state_index-%d\n" , 
total_threads, current_atate_index) ; 

if <current_state_index == total_threads - 1) ( 
if (current_state_index + 1 >- MAX — STATES ) { 
printf ("findNewIndexl <) ; returning -1 \n")/ 

return -1; # ^ 

> .! 
else { 

printf ("findNewIndex2 () : returning %d\n", current_state_index + 1) ; 
return ++current_state.index; 

) 

\ 

else 

for (i=Q; i<=current_state_index; i++) { 
if (!state_array [i] .valid) { 

printf ( "findNewIndex3 () : returning %d\n", i); 
return i; 

> 

) 

printf ("f indNewIndex ( ) : impossible! ! !\n") ; 

} 



int findLM <uint32_t lm^addr) 
{ 

int i; 

for (i»0; i<-current. st at e_ index; i++) { 

if (state_array[il .valid &6 state_array [i ] . lm_addr — lra_addr) { 
printf ("findLM () : returning index %d\n", i) ; 
return i; 

) 

i 

printf ( "findLM () : returning -l\n"); 
return -1; 



int commercial (int state_index, int path.length, const char *path) { 
FILE *fd; 

printf < "commercial (state_index«%d # path_length-%d) \n". 
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if (state.index ™ -1 II path.length <- 0) return ERROR; 

if (state.array (state_index] . fd) f close (state. array (state_index) . f d) ; 

fd = fopen(path, "r") ; 
if <fd — NULL) { 

printf ( "commercial () : error opening file\n"); 

return ERROR; 

\ 

state_array [state.index] .fd - fd; 

state_array(state_index] . request.type = COMMERCIAL; 
return OK; 



int localPlay (uint32_t lm_addr, int path.length, const char *path) ( 
FILE *fd; 

int state_index, status; 

printf < "localPlay (path_Iength=%d, path-%s\n*, 
path.length, path) ; 

if (path.length <=» 0) return ERROR; 

fd - fopen<path, "r") ; 
if (fd == NULL) { 

printf ("localPlay 0 : error opening file\n"); 

return ERROR; 

} 

state_index - f indNewIndex <) ; 

if ( stat e_ index ™ -1) return S TAT E S_FULL ; 

/* create new state entry */ 
state_array (state.index) .fd - fd; 

state. array [st at e__ index) . request_type » LOC AL_P LAY ; 
state.array tstate.indexl .n*. addr » NULL; 
state_array [state.indexl .lnL_addr - ln*_addr; 
state. array [state_index] .valid - TRUE; 

total_threads++; 

/* create a new playing thread (using old state entry) */ 
if ( (status - 

pthread_create (& (stat«_array { state_index] .tid) , 

NULL, processRequest, (void *) state.index) ) !- 0) { 
printf ( w play2: can't create thread: error # %d\n", status); 
exit (D? 

} 

return OR; 



void sendStatus (uint8_t status) 
( 

uint8 — t s » status; 
write (connfd, &s, 1); 



void *processRequest (void* index) 
< 

struct ip_jnreq nureq^pi, mreq_lni; 
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struct sockaddr_in sin_m, ain.Lra; 
int sock_m»-l, sock_lrn; 
int numread; 
rtp_packet *rp; 

char buffer lMAX_PAYLOAD_SIZE 4- FIXED_PKTLENGTH ) ; 

char payload_buf [MAX_PAYL0AD_SIZE) ; 

FILE *fd; 

uintl6_t seq; 

uint32_t ssrc, ts; 

int lastPlaySeq=0, numAdSeq«0; 

uint32_t state_index « <uint32_t) index; 
uint32_t m_addr » state_ar ray (state_index) .m_addr; 
uint32_t Lm_addr » state.array [ state_index] . lm_addr; 
int addr_len = sizeof (struct sockaddr_in) ; 

printf ("in processRequest ( index=%d> m_addr - %x, lm_addr - %x, multicast j>ort*%d\n% state, 
index, m_addr, lm_addr, mult icast_port) ; 

if (state.arrayfstate. index] . request_type !- LOCAX_PLAi> { 
mreq^m. imr_mult iaddr . s_addr = htonl (m_addr) ; 
mreq_m. imr_int erf ace . s_addr « htonl ( INADDR^_ANY) ; 

if <<sock_m = socket (AF_INET, $OCK_DGRAM, 0)) < 0) < 
perror ("socket") ; 
exit(l); 

) 

if (setsockopt <sock_m, IPPR0T0_IP, IF_ADD_MEMBERSHIP, (char *)&mreq_ra, 

sizeof < struct ip_mreq) ) < 0) ( #: 
perror ("setsockopt sock_ju*); 
exit (1) ; 

} 

sin_m.sin_addr .s_addr - htonl (m_addr) ; 
sin_m.sin_port - htona (multicaatjort) ; 
sin_nwsin_fainily = AF_INET; 

if (bind (sock_m, (struct sockaddr *)&sin_jn, sizeof (sin jn) ) < 0) { 
perror ("bind") ; 
exit (1) ; 

if (fcntl <sock_rn, F_SETFL, 0„NDELAY) < 0) { 
perror ("fcntl") ; 
exit (1) ; 

) 

} 

mrec^lm.imr_multiaddr.3_addr • htonl (lttL-addr) ? 
mreq_lra.imr_interface-s_addr - htonl (INADDR^ANY) ; 

if ( (sock_lm - socket (AF_INET, SOCK^DGRAM, 0) ) < 0) < 
perror ( "socket" ) ; 
exit (1) ; 

} 

if (setsockopt <sock_lm, IPFROTO_IP, IF^ADD_HEMBERSHIP, (char *)6mreq_lm, 
sizeof (struct ip_jnreq) ) < 0) ( 
perror ("setsockopt sock. lm"); 
exit(l); 

\ 

sin_lra.sin_addr.s_addr - htonl Um_addr> ; 



3NSDOCID: <WO 0079734A1J_> 



WO 00/79734 



PCTAJS00/16913 



RA3.C Thu Jun 13:14 1999 

sin^lm.sin^port = htens {mult icast. port ) 



if (bind (sock_J.m, (struct sockaddr *>*sin_lm, sizeof <sin_lm> ) < 0) i 
perror ( "bind") ; 
exit (1) ; 

> 

/* we want the call to recv td be non-blocking */ 
if (fcntl <sock_lm, F_SETFL, 0_NDELAY) < 0) { 

perror (" f cntl") ; 

exit (1); 

I 

printf ("processRequest ( index=%d) : request_type= s %d\n" , 

state_index, 3tate„array I state_index] „ reque3t_type) ; 

while (TRUE) ( 

switch { state^array [ state_index] . request_type> ( 
case PLAY: 

/* check whether there is information on the socket */ 
nurnread - recv(sock.m, buffer, sizeof (buf f er) , 0); 
if <numread>0) { 

rp = (rtp_ packet •*) buffer; 

if tabs (ntohl (rp->RTP_header. seq) - lastPlaySeq) >- numAdSeq-1) { 
lastPlaySeq » ntohl ( rp->RTP__ header , seq) ; 

numAdSeq = 0 ; , i 

if (sendto(sock_lm, buffer, nurnread, 0, (struct sockaddr •) &sia_lra, * sizeof (str 
+ ct sockaddr_in) ) < 0) ( 

perror ("sendto") ; 
exit (1) ; 

) 

> else i 

printf ( "Ornmi ting an old packet\n">; 

} 

> 

break; 

case COMMERCIAL: 
case LOC AIRPLAY: 

/* default action after we finish the commercial */; 

/* state_array [state_index] . requeat.type - PLAY; */ 

ssrc = randora32 (1) ; 
seq • 0; 
ts - 0; 

fd - state_array [state__indexj . fd; 
while (TRUE) 4 

if <state_array(state__indexj ,request_t ype !- COMMERCIAL £& 

state_array [state_index] . request.type !- LOCAL. PLAY) 
break; 

nurnread - fread (payloaoUbuf , 1, MAX_PAYLOAD_SIZE r fd) ; 
if (nurnread <- 0) { 

fseek(fd, 0, SEEK_SET) ; 

continue; 

} 

rp =* (rtp_packet *) buffer; 
rp->RTP_header. version - RTP_VERSION; 
rp->RTP_header.p - 0; 
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rp- > RTP.heade r . x - 0 ; 

rp->RTP_header . cc - 0; 

rp->RTP_header . pt - 0; 

rp->RTP_header. seq - htonl (seq) ; 

rp->RTP_header . ts - htonl(ts); 

rp->RTP_header . ssrc - htonl (ssrc) ; 

rp->pay load_len • htonl (numread) ; 

memcpy i rp->pay load, payload_buf, numread); 

if tsencto occk.lm, buffer, FIXED_PKTLENGTH + numread, 0, (struct sockaddr *)6sin_lm, 
sizeof (struct soe*addr_m) ) < 0) ( 
perror <*sendto - ) ; 
exit \ 1 1 i 

\ 

if (ts >- LIWT.KAX - numread/8 I I seq >« USHRT__MAX - 1) { 
seq - 3; 
ts - 0; 

) 

else i 

seq**; 

ts *~ ru*(t«d/lj 

} 

numAdSeq**; 

usleep ( irunr»«d/9 - *0i • 1000); 
/* yield to iwrtMr t hr««c •/ 

sched_ yield ( i ; 

) -* 

brealc; , * 

default: /* eitntr 3TO* or unknown request status */ 
if <sock_m >- 01 
close (sock_«) ; 
close (sock_lm) s 

state_array (stat«_mdea| .valid - FALSE; 

printf (*procea$l»equest t ind««-%d) : request_type=%d. Returning NULL. \n" , 
state_ xno«i. st«te.arcay [ state_index) . request_type) ; 

return NULL; 
} /* switch */ 

sched__yieldO ; 
) /* while (true) */ 

) 

int playdnt state_ind«x, uint32_t m_addr, uint32_t lm_addr) { 
int status; 

printf ( 'play <state_iino>e*-%d ...): total_treads=%d, current_state_index-%d\nV 
state_index, total. threads, current_state_ index) ; 



/* If we already have an identical M-to-LM binding */ 

if (state_index !» -1 44 stAtf.array [st ate_index ] .m_addr nrL_addr) { 
if <state_array t state_mdex| . request. type ™ PLAY) { 

printf Cplay (»tate_index-%d . ..): M-to-LM binding already exists\n", 

state_index) ; 
return (DUPLICATE); 

) 

if (state_array tatate.index] .request. type «- COMMERCIAL) { 

printf ("play lstate_index=%d ...): switching from commercial to play\n". 
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st *te_index) ; 
state_array [ 3 tate__index] . request_type - PLAY; 
return OK; 

/* If LM is already being used and M is different */ 
if <state_index !» -1) { 

printf < "play (state_index=%d ...): existing LM, new M\n" # 
state_index) ; 

/* NOTE: need synchronization here */ 

state_array [st ate_index| . request_type 38 STOP; 

printf ( *play ( ) : waiting for thread to terminate\n") ; 

whi Le <state_array [state_index] . valid) { /* wait for thread to terminate */ 
/* NOTE: can use condition variables here, or pthread_join ( ) */ 
usleep(lOOO) ; 

> 

printf ( "play () : thread has terminated. Proceeding ... \n ■) ; 

/* modify the old thread's state entry */ 
st ate_array ( st ate.index] .ra_addr - m_addr; 
state_array [ st ate_index] . request_type - PLAY; 
state, array [ st ate_index] .valid ** TRUE; 

/* create a new playing thread (using old state entry) */ 
if ( (status - 

pthread_create {& (state_array { state_index) .tid) , 

NULL, processRequest, (void *) state_index> ) !- 0) ( 
printf ("playl : can't create thread: error # %d\n", status); 
exit(l); 

} 

return OK; 

) 

/* here, we have a new LM */ 

printf ( "play { state_index=%d) : new LM\n", state_index) ; 

/* NOTE; also synchronization needed below */ 
state_index *» findNew Index <) ; 

if (state_index — -1) return S TATE S — FULL; 

/* create new state entry */ 
state_array [state n index] .iq_addr — m_addr; 
state_array [state__ index) . ln*_addr - lm_addr; 
state_array [state„indexl .request_type - PLAY; 
state_ar ray [stat e_index) . fd - NULL; 
state_array (3tate_ index J .valid - TRUE; 

/* NOTE: synchronize here */ 
total_threadsi-+; 

/* create a new playing thread (using old state entry) */ 
if ( (status - 

pthread_create (4 (state_ array I state., index] .tid) , 

NULL, processRequest, (void *) state.index) ) !~ 0) i 
printf ( w play2 : can't create thread: error # %d\n", status); 
exit(l); 
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return OK; 



oid stoplint state__index) { 
printf ("stop (state.i index=%d) : total_treads-%d, current_state.index=%d\n", 
state_index, total.threads, current.state_index) ; 

/* NOTE: synchronize */ 

state.array [state.index) . request. type - STOP; 

printf <"stop(state_index=%d) : waiting for thread to terminateXn 1 , 
state. index) ; 

while (state.array [state.index) . valid) { /* wait for thread to terminate */ 
/* NOTE: can use condition variables here, or pthread_join ( ) */ 
usleep < 1000) ; 

printf ("stop <state_index=%d) : thread has terminated. Continuing. . An , 
state_index) ; 

total.threads — ; 

if (state.index »■» current. state. index) ( 

while (state.index >- 0 && ! state.array [state.index — J .valid) { 
current.state.index — ; 

> 

} 
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-import java.io.*; 

import java.net.*? 

import java . lar.g . * ; 

, import java . ut i 1 . * ; 

public class Marconi { 

private InputStreara is; 
private OutputSt ream os; 
private Socket sock; 
private Kashtable h; 

public Marconi O ( 

h - new Hashtablet); 

\ 

public static void main (String args () ) throws Exception ( 
if (args. length !• 3) { 

System . out . print In < "Marconi Server demo program: usage: " + 

"Marconi <RAS hostname> <RAS port> <RTP port>"); 
Sysiefi.out.prmtlnCNnRun this program in place of Marconi " 
•Server, to manually send requests to the Radio Antenna Server. - ); 
System . exit ( 1) ; 

\ 

Marconi it • new Marconi <) ; 

// create a TCP socket for communication with the RAS 
int rtcpPort - Integer .parselnt (args [21 ) -t- 1; 
m.sock - new Socket (args ( 0 ] , Integer . parselnt (args [ 1 ])) ; 
m.is - ra. sock. get InputSt ream (> ; 
ra.os - re. sock .getOutputStrearaO ; 

char choice; 
String command; 
String (1 comroandArray; 
byte [ ) requestPkt/ 

while(true) ( 

ProniptUser. display () ; 

choice - PromptUser .get Input <) ; 

switch (choice) { 
case ' 1* : // play 

// get M and LM 

conmandArray - PromptUser .get PI ayCommandO ; 
System. out .print ("Sending command: *) ; 
System. out . print In ( "PLAY " + commandArray [0) + ■ ■ + 

commandArray [11); 
requestPkt - ra. encodeRequest ( (byte ) 1, commandArray 10) , 

commandArray [ 1] , null); 

ra. sendRequest (requestPkt) ; 

InsertAd iad - new InsertAd (commandArray, rtcpPort, m) ; 
m.h. put (commandArray [1] # iad); 
iad. start () ; 

break; 

case '2' : // stop 
// get LM 

command - PromptUser .get St opCommand () ; 
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System . out . print ( "Sending command: •) ; 
System. out . println ("STOP " + command); 
requestPkt * m.encodeRequest ( (byte) 2, null r 

command, null) ; 

m. sendRequest (requestPkt) ; 

insertAd th - < InsertAd) m . h . get (command) ; 
if (th !- null) < 
th . stop ( ) ; 

ra.h. remove (command) ; 

break; 

case '3': //local play 

CommandArray = PromptUser . getLocalPlayCommand ( ) ; 
System. out . print ( "Sending command: ") ; 

System, out. println ("LOCAL PLAY • + commandArray [ 0 1 + ■ • + 
commandArray [11); 

Schedule sch = new Schedule (commandArray, m) ; 

sch. start ( ) ; 

break; 

case * e' : 

System. out .println("\n Try again. \n*); 
break; 

case ' q' : 
case ' Q' : 

m . sock. close ( ) ; 

System. exit (0) ; 

default: 

System. out .println ("Invalid option. Try again."); 
} // switch 

) // while true 

> // main 



public synchronized void sendRequest (byte [ 1 requestPkt) 
( 

bytef) statuaPkt - new byte[l]; 
int byteaRead; 

try { 

// send request to the RAS 

os. write (requestPkt, 0, requestPkt . length) ; 

// read the status returned by the RAS 

if ((bytesRead - is. read (atatusPkt) ) < 1) < 

System. err .println ("\nError: status not received. \n*) ; 

} 

else { 

System. out .println ("RAS returned status: • 

+ statusMeaning<statusPkt [0] ) ) ; 

> 

} catch (Exception e) { 

System. out .println (e .getMessage ( ) ) ; 

) 

> 
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public bytef] encodeRequest (int requestType, String m_ado*. 

String lm_addr, String path) 

int m - 0, lm - 0, pathLength = (reque3tType ==311 requestType 
*= 4) ? path, length () : 0; 

if <m_addr !- null) m = getlntegerIP (m_addr) ; 
if (lm_ addr !- null) Lm « get Integer IP ( lm_addr) ; 

// NOTE: we allocate 1 byte for path even if there's no path 
// <this conforms to the RequestPacket structure of the RAS) 
bytetl buffer = new byte 1 13 + ((requestType — 311 requestType 
=~ 4) ? pathLength : 1)); 



buffer [0] = (byte) ((requestType << 16) >>> 24); 

buffer[l] * (byte) ((requestType « 24) >>> 24); 

buffer [2] - (byte) ((pathLength « 16) >>> 24); 

buffer (3) = (byte) ((pathLength << 24) >>> 24); 



// request_type 



// path_length 



// m 

if (requestType 
buffer[4J = 
buffer[5] » 
buffer [6] - 
buffer [7] - 

) 

else { 

buffer[4] - 
buffer [5] - 
buffer(6] - 
buffer [7] - 

) 



— 1) { // play 
(byte) (m »> 24) ? 
(byte) ( (m « 
(byte) ( (m « 
(byte) ( (m « 



// 

8) >>> 24) ; 
16) >>> 24) ; 
24) >» 24) ; 



4 bytes of ra 



// lm 

buffer (8] » (byte) (lm >» 24); // 4 bytes of lm 

buffer (91 - (byte) ( (lm « 8) >» 24); 
buffer(10J - (byte) < (lm « 16) >» 24); 
bufferlll] - (byte) ( (lm « 24) »> 24); 

if (requestType — 3 I I requestType — 4) ( // commercial 
byte[] bytePath - path . get Bytes () ; 

for (int i - 0; i < bytePath. length? i++> ( 
bufferl!2 + i] - bytePath li) ; 

} 

} 

else i / / send a xero byte as the path if the path is empty 
buffer [12) - 0; 

) 



return buffer; 



private static int getlntegerIP (String addr) { 

StringTokenizer at - new StringTokenirer (addr, ".*); 
int ip - 0; 

try ( 

ip - 
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Integer .parser nc <st . nextToken { ) ) 
Integer . parse Int <st .next Token ( ) ) 
integer . parselnt (st . nextToken ( ) ) 
Integer .parsernt (st . nextToken ( ) ) 



* 256 

* 256 * 256 + 

* 256 + 



) 

catch (Exception e) [ 

System. out -println < "getlntegerlP () : error: * + e .getMessage ( ) ) ; 

) 

return ip; 
) // getlntegerlP 

private static String st atusMeaning (byte status) < 
switch (status) { 
case 0: return *OK"; 
case 1: return "ERROR* ; 
case 2: return "DUPLICATE"; 
case 3: return * STATES_FULL" ; 

default: return " <UNKNOWN_STATUS»" + status + ")"; 
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"public class InsertAd extends Thread 

I 

private String mAddress; 
private String ralAddress; 
private int mPort; 
private Marconi marconi; 
private InetAddress mGroup; 
private MulticastSocket ms; 
private Vector adList; 
private int lastSeq; 

public static final int pLength » 24; 

public InsertAd (String [] command, int p, Marconi m) { 
mAddreas - comn\and[0); 
mlAddress *= conunand(l]; 
mPort =» p; 
marconi = m; 
lastSeq = -1; 
adList » new Vector (); 

) 

private int decodelnt (byte [] buffer, int start) { 
int result - 0; 

* 

result l« ( (buffer (start + 3] « 24) »> 24); \ 
result 1- { (buffer (start+21 « 24) >» 16); 
result I- ( (buffer [start + lj « 24) >» 8); 
result I- (buffer [start] <<24); 

return result; 

) 

public void run() { 
try ( 

mGroup - InetAddress .get ByName (mAddress) ; 
ms « new MulticastSocket (mPort) ; 
ms . joinGroup (mGroup) ? 

Buf feredReader br - 

new Buff eredReader (new FileReader (mAddress ♦ ".lst*)); 

String str; 

while ((str - br . readLine ( ) ) !- null) { 
if (str .equals C - ) ) continue; 
adList .addEleroent (str) ; 

> 

br . close () ; 

byte (] buffer - new byte [pLength] ; 
int current Ad - 0; 
byte [J requeatPkt; 

while (true) i 

DatagramPacket recv - new DatagramPacket (buffer, pLength) ; 
ms . receive (recv) ; 

int version • ((buffer (01 << 24) »> 30); 
int subtype - buffer [0] 6 31; 



WO 00/79734 
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- import java . net . * 
- import java.util. 
import java.io.*; 
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int pt =• <<buffer[l] « 24) »> 24); 
short length =- 0; 

length I- ((buffer [3] << 24) >>> 24); 
length |- (buffer(21 << 8 > » 

int 33rc - decodelnt (buf f er, 4) ; 

int cSeq » decodelnt (buf fer, 12); 

int remaining - decodelnt (buf fer, 16); 

int cLength - decodernt (buf f er, 20); 

/* System. out .println ("Received packet:" + 
■ version-" +■ version + 
• subtype-" +■ subtype + 
" pt=»" + pt 
" length-" ♦ length + 
" ssrc-" + ssrc + 
" aeq- B + cSeq + 
" remaining-" + remaining + 
" cLength=" ♦ cLength) ; */ 

if (version !- 2 || subtype !- 1 II length !- pLength/4 - 111 
pt !- 204 If !(buffer[8] — ' M' && buffer[9] ~ 'a' 
&i buffer(10] ~ ' r' && bufferlll] — 'c')) 

{ 

System, out .println ("Received an invalid packet!"); 
continue; 

) 

s 

if (cSeq — lastSeq) ( ,! 
//System. out .println ("Received a retransmit packet!"); 
continue; 

) 

System. out .println ("Commercial starting in • + 

remaining ♦ • seconds, lasting " ♦ cLength + ■ seconds"); 

lastSeq - cSeq; 

Thread. sleep (remaining * 1000); 

requestPkt - niarconi .encodeRequest ( (byte) 3, null, 

ralAddress, (String) adList .elementAt (currentAd) ) ; 
marconi . sendRequest (requestPkt ) ; 

System. out .println ("Commercial " ♦ 

(String) adList .elementAt (currentAd) + " Started .-."); 
Thread. sleep (cLength * 1000); 

requestPkt - narconi . encodeRequest ( (byte) 1, mAddress, 

mlAddress, null); 
marconi. sendRequest (requestPkt ) ; 

System. out .println (".. . Commercial " + 

(String) adList .elementAt (currentAd) + " Finished"); 
currentAd - (currentAd +1) % adList .size O ; 

) 

} catch (Exception e) ( 

e . print St ackTrace ( ) ; 

> 

) 

public void leave () ( 

try { ms. leaveGroup(mGroup) ; \ 

catch (Exception e) { e .print StackTrace () ; } 



16 



3NSDCCID: <WO_0079734A1 J_> 



PCT/US00/16913 

3 



17 



BMSDOCID: <WO 0079734A1J_> 



WO 00/79734 

I^trtAd.java Th« Ju^p 14:13:54 1999 



WO 00/79734 



PCT/US00/16913 



tRC.jav* Thu Jua 17 ^^14; It) 1999 1 

import java . net . * ; 
import java.io.*; 
import java.util-*; 
import j ava . lang . Math - * ; 

public class IRC { 

* constants defining buffer sizes, etc. 
*/ 

public static final int payloadKBytes =» 4; 

public static final int payloadBytes = payloadKBytes • 102 4; 

public static final int reset *» 50; 

public static final int maxBuff erEnt ries «* 500; 



private BufferEntry be; 
private CircBuffer cb; 

private byte(] buffer; 

private boolean newSequence «• true; 

private int startSeq; 

private int startTs; 

private long startTime; 

private long current_of f set; 

private int currentSeq; 

private int sarc; 

public IRC () < 

cb =• new CircBuf f er (rnaxBuf f erEntries) ; •* 
\ I : 



public boolean checkNewSequence (Buf f erEntry be) { 

if (newSequence M Math, aba (be . seq - currentSeq) >- reset 
I | be.ssrc !•■ ssrc) { 

System, out .println ("NEW SEQUENCE 1 is!!!!!!!!!!!!!!!!!! t !!!!!") ; 
return true; 

> 

else return false; 



public void initVarsO ( 
startSeq ■ be. seq; 
3tartT3 - be.ts; 
sarc - be.ssrc; 
Date d = new DateO; 
startTime - d.getTimeO ; 

current_of fset - startTime - startTs ♦ 512 * 20; 
if (newSequence) { 

currentSeq • startSeq; 

) 

newSequence — false; 



private void decodePacket ( ) { 
int bO, bl, b2, b3; 

be - new Buff erEnt ry () ; 

be.v - (buffer(O) « 24) »> 30; 

b0 - (buffer [2 J « 24) >» 24; 
bl - (buffer [3] « 24) »> 24; 
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be.seq • (b° << 8) | bl; 



bO « buffer [4] ; 
bl - buffec[5] ; 
b2 - buffer [6J ; 
b3 - buf fer [7J ; 
bO - IbO << 24) 
bl - (bl << 24) 
b2 - <b2 « 24) 
b3 - (b3 « 24) 



>>> 24 

>>> 24 

>>> 24 

>» 24 



be.ta - (bO « 24) I (bl « 16) I <b2 << 8) 



b3; 



b9 * buffer 18); 

bl - bufter(9); 

b2 • buffer [10|; 

b3 • bufferllt); 

bO - (bO << 24> >» 24; 

bl - <bl << 24) >>> 24; 

b2 • iC2 24) >>> 24; 

b3 • inJ *< 24) *»> 24; 

be.ssrc - 4bO << 24) I (bl << 16) I (b2 << 8) I b3; 



bO • buffet ' 14! . 

bl - buffer I i?i . 

b2 - &wf fer i It: ; 

b3 - buffet t 191 ; 

bO • (DO ** 24) ►>> 24; 

bl - Ibl << 24} **> Z4; 

b2 - (b2 << 24) >» 2%; ,* 
b3 - Ib3 «« 24) >>> 24/ , t 

be. length • IbO « 24) I (bl « 16) | (b2 « 8) I b3; 

be. pay lead * rw fcyte Ibe . length] ; 

for unt i • 20; l < be. length + 20; i++) { 

be.payloedU - 20| - buffer [i]; 

> . 



public static void main (String [ ] args) ( 
try ( 



IRC ire • new IRC(); 



if (arge. length ! - 2) { 

Syatea. out .print In ( "Usage : IRC ^multicast addr> <port>*) ; 
return; 

} 

String acaatAddr - args[0]; 

int port - Integer. parselnt (args CD ) ; 

// join a Hult icast group 

InetAddreee group - Ine t Address -get ByNanie (mcastAddr) ; 
MulticeatSocket a - new MulticastSocket (port) ; 
s . jolnGroupt group) ; 

ire. buf fer • new byte (payloadBytes + 20]; 
ire. cb. start <) ; 



while (true) 4 

DacagranFacket recv - new DatagramPocket ( ire ♦ buf f er, ire. buf fer . length) ; 
s . receive ( recv) ; 
ire .decodePacket < ) ; 
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System. out . println ( * received packet: - «■ 

" seq— • + ire. be. seq + 

• t3=" + irc.be.ts + 

• length-* + ire . be . length + 

• ssrc 3 " + irc.be.ssrc) ; 

if (irc.checkNewSequence (irc.be) ) 
ire . initVars ( ) ; 

ire .currentSeq - ire. be. seq; 

ire .be . of f set = ire . current__of f set ; 

Date date =• new DateO; 
long time « date .getTime ( ) ; 

irc.cb .enqueue (ire .be) ; 



) // while true 

) 

catch (Exception e) { 

e.printStackTrace () ; 

> 

) // main 
J // IRC 
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import java.io.*; 
import java.net.*; 
import java.lang.*; 
import java.util.*; 

public class Marconi { 

private InputStream is; 

private OutputStream os; 

private Socket sock; 

private Hashtable h; 

public Marconi () \ 

h * new Hashtable (); 

) 

public static void main (St ring args (] ) throws Exception i 
if (args- length !- 3) { 

System. out . print In ("Marconi Server demo program: usage: " * 

"Marconi <RAS hostname> <RAS port> <RTP port>") ; 
System. out . println ("\nRun this program in place of Marconi * + 
"Server, to manually send requests to the Radio Antenna Server."); 
System. exit ( 1 ) ; 

) 



Marconi m - new Marconi (); 



// create a TCP socket for communication with the RAS 

int rtcpPort - Integer .parselnt (args t 2) ) +1; , * 

m.sock - new Socket (args ( 0 1 , Integer . parselnt (args [ 1 ])) ; € * 
m.is =■ m.sock .get InputStream () ; 
m.os - m. sock .get OutputStreara () ; 



char choice? 
String command; 
String [] commandArray; 
byteU requestPkt; 

while (true) { 

Prompt User .display () ; 



choice - PromptUser .get Input () ; 

switch (choice) { 
case ' 1' : // play 
// get M and LM 

commandArray - PromptUser .get PlayComniand <) ; 

System. out .print ("Sending command: •) ; 

System. out .print In ("PLAY " + commandArray (0) + " " + 

commandArray [ 1 ) ) ; 
requestPkt - ro.encodeRequest ( (byte) 1, commandArray [0] , 

commandArray (1) , null); 



m.sendRequest (requestPkt) ; 

InsertAd iad - new Insert Ad (commandArray, rtcpPort, m) ; 
m.h.put (commandArray [1] , iad); 
iad. start () ; 



break; 

case '2' : // stop 
// get LM 

command • PromptUser .get St opContmand () ; 
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System. out .print ( "Sending command: "); 
System. out .print In ("STOP " + command); 
requeatPkt = m.encodeRequest ( (byte) 2, null, 

command, null) ; 

m.aendRequeat (requestPkt ) ; 

InaertAd th ~ { insert Ad) m.h . get (command) ; 
if (th !- null) { 
th.stopO; 

m.h. remove (command ) ; 

I 

break; 

c«it * 3 # : //local play 

coamandArray = PromptUser . get Local PI ay Command () ; 
Syaten. out . print ( "Sending command: "); 

5yst«n.c;Lt . println ( "LOCAL PLAY " ■»- commandArroy [ 0 ) + • " + 
commandArray [ 1 ] ) ; 

Schedule »c* - new Schedule (commandArray, m) ; 
ach . st art i ) ; 

c«st * e* : 

Systee.cit . pc intln ("\n Try again. \n") ; 

cam *q* : 
cam '0' : 

m . tock .close i ) ; 

3yst**.e*«t (0) ; 

default : 

Systee.out .println (Tnvalid option. Try again.*); 
) // •witch 

) // while true 

) // main 



public synchronised void sendRequest (byte ( ] requestPkt) 
( 

bytef] statuaPkt • new byte [1 J; 
int bytesReed; 

try { 

// send request to the FAS 

oa . write < requestPkt , 0 , requestPkt . length) ; 

// read the status returned by the RAS 

if ((bytesfteed - is. read (statusPkt) > < 1) { 

Systeai. err. println ("\nError: status not received, \n m ) $ 

) 

else { 

System. out .println ( "RAS returned status: * 

+ statusMeaning (statuaPkt [0] ) ) ; 

1 

} catch (Exception e) { 

System, out. println (e.getMessage () ) ; 

} 

) 
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public byte[] encodeRequest ( int requestType, String m_adar, 

String lra_addr. String path) 

int m » Or lm » 0, pathLength = (requestType -» 3 I I requestType 
4) ? path . length ( ) : 0; 

if <m_addr null) m = getlntegerIP <m_addr) ; 
if <lm_addr !- null) Ira - get Integer IP (lm_addr ) ; 

// NOTE: we allocate 1 byte for path even if there's no path 
// (this conforms to the RequestPacket structure of the RAS) 
byte { I buffer = new byte[13 + ( (requestType ==311 requestType 
*- 4) ? pathLencth : 1)1; 

buffer(C. - (byte) ((requestType « 16) »> 24); // request. type 

buffcr(i; - (byte) ((requestType « 24) >» 24); 

buffer (2: - (byte) ( (pathLength << 16) >>> 24); it path_length 

buffer 13 - (byte) ((pathLength « 24) >>> 24); 

// n 

if (requestType — 1) ( // play 

buffer [4] - (byte) Cm >>> 24); // 4 bytes of m 

buffer{5] - (byte) ( (ra « 8) >>> 24); 
buffer (6) - (byte) < (m « 16) >» 24); 

buffer p) - (byte) ( (ra « 24) »> 24); . 

else ( 

buffer(41 - 0 
bufferlSl - 0 
buffer [6) = 0 
buffer P) - 0 

) 

// Ire 

buffer 18) - (byte) (Ira »> 24); // 4 bytes of lm 

bufferO) - (byte) ((lm « 8) »> 24); 
buffer[10) - (byte) (dm « 16) »> 24); 
buffer(ll) - (byte) ( (lm « 24) »> 24); 

if (requestType — 3|| requestType — 4) { // commercial 
byte I J bytePath - path.get&ytes ( ) ; 

for (int i - 0; i < bytePath . length; H-+) { 
buffer [12 + i) - bytePath [i]; 

) 

} 

else < // send a zero byte as the path if the path is empty 
buffer[12] • 0; 

) 

return buffer; 



private static int getlntegerIP (String addr) { 

StringTokenizer st - new StringTokenizer (addr, ".•); 
int ip - 0; 

try < 

ip - 
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IntegerTparselnt (st . nextlokenO ) * 256 
Integer .parselnt (st . nextToJten () ) * 256 - 
rnt eger . parse Int (st . nextToken < ) ) * 256 + 
Integer .parselnt (st . nextToken ( ) ) ; 



) 

catch (Exception e) ( 

System. out. println ( "get Integer IP ( ) : error: ■ + e . getMessage ( ) ) ; 



return ip; 
* // getlntegerIP 

private static String st atusMeaning <byte status) { 
switch (status) { 
case 0: return "OK"; 
case 1: return "ERROR"; 
case 2: return " DUPLICATE" ; 
case 3: return " STATE S_FULL" ; 

default: return ■ (UNKNOWN_STATUS-" + status + *)"; 
) 



* 
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-import java.net.*; 
'import java.util.*; 
import java.io.*; 

-Public class RsSendRTCP extends Thread 

( 

private String mAddress; 

private int raPort; 

private String scheduleFile; 

private int ssrc; 

private I net Address mGroup; 

private Mult icast Socket ms; 

private int cSeq; 

private Hashtable hTable; 

public static final byte version =■ 2; 
public static final int pLength * 24; 
public static final int retransmit - 3; 
public static final byte subtype - 1; 
public static final int maxHash » 7 * 86400; 

public RsSendRTCP (String addr, int p. String file) 
i 

mAddress «■ addr; 
mPort - p; 

scheduleFile - file; 

ssrc - (int) ( java . lang • Math. random <) * 10000); 
cSeq - 0? 

hTable - new Hashtable (); 

) 

public void run ( ) { 
try i 

mGroup - Inet Address . get ByNanie (mAddress) ; 
ma - new MulticastSocket (mPort) ; 
ms . joinGroup (mGroup) ; 

Buf feredReader br - new Buf feredReader (new FileReader (scheduleFile) ) ; 

String str; 

int lineNum » 0; 

while ((str » br . readLine () ) !- null) < 
lineNum++; 

if (str. equals ("•) ) continue; 

StringTokenizer st - new StringTokenizer (str, * St*); 
if ( st. count Tokens () !- 5) < 

Systea.err. print In ("Illegal number of parameters on line * 
+ lineNum + • of ■ + scheduleFile) ; 

continue; 

> 

int day • Integer .parselnt (at .nextToken ()) ; 
int hour - Integer .parselnt (st .nextToken ()) ; 
int minute • Integer. parselnt (st .nextToken ()) ; 
int second — Integer .parselnt (st .nextToken ()) ; 
int duration • Integer .parselnt (st . nextToken ()) ; 
day — ; 

int hash - day * 8 6400 + hour * 3600 + minute * 60 + second; 

// System. out. println ("Inserting • ♦ day ♦ ■ * + hour ♦ ■ ■ + 

// minute ♦ ■ • + second + " • + duration ♦ ■ • ♦ hash); 

hTable .put (new Integer (hash) , new Integer (duration) ) ; 
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} 

br. close {) ; 



while (true) ( 



Calendar myCalendar - Calendar .get rnstance <) ; 
:nt day - myCalendar . get (Calendar . DAY_OF_WEEK) ; 
int hour - myCalendar .get (Calendar .HOUR_OF_DAY> ; 
int minute =» myCalendar . get (Calendar .MXNUTE) ; 
int second ~ myCalendar .get (Calendar . SECOND) ; 
day — ? 

int hash = (day * 86400 + hour * 3600 + minute * 60 + 
second +• retransmit + 1) % maxHash; 



// System, out .println ( "Now is " + day + ■ • + hour + " " + minute +- 
U m m + second) ; 



tnteger d; 

if ( (d - (Integer) hTable. get (new Integer (hash) ) ) !- null) ( 
int duration - d . intValue ( ) ; 



// create an RTCP packet 

byte (1 buffer = new byte [pLength ] ; 

buffer (0) ~ (byte) (version << 6); // version, 

buffer(O) |» subtype; // subtype 

buffer[lJ = (byte)204; // pt 



short 1 - pLength/4 - 1; 



buffer [2] 
buffer [3] 



(byte) 
(byte) 



(1 >» 
( (1 « 



8); // length (higher byte) 

8) »> 8); // length (lower byte) 



// ssrc 

buffer {4) = (byte) (ssrc »> 24); 

buffer (5] - (byte) ((ssrc << 8) >» 24); 

buffer (6] - (byte) ((ssrc « 16) »> 24); 

buffer [7] - (byte) ((ssrc << 24) >» 24); 



// name 

buffer [8] - 'M' ; 
buffer (91 - 'a'; 
buffer [10] - ' r' ; 
buffer [11] - 'c' ; 



// cseq 

buffer (12] - (byte) (cSeq >>> 24); 

buffer [13] - (byte) ( (cSeq « 8) >>> 24); 

buffer [14] - (byte) { (cSeq « 16) >>> 24); 

buffer [15] - (byte) { (cSeq « 24) >>> 24); 

cSeq - <int) ( (cSeq — 32767) ? 0 : cSeq + 1); 



// length of commercial 
buffer[20] - (byte) (duration >» 24); 
buffer [21] - (byte) {(duration << 8) >>> 24); 
buffer [22] - (byte) ((duration « 16) >» 24); 
buffer [23] - (byte) ((duration « 24) »> 24); 

for (int i - retransmit+1 ; i>0; i — ) { 



// time remaining t 
buffer [16] - (byte) 
buffer[17J - (byte) 
buffer(18] - (byte) 
buffertl9] - (byte) 



commercial 
(i »> 24) ; 
( (i « 8) >» 24) ; 
( (i « 16) »> 24); 
((i « 24) >» 24); 
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System - out . print In < 

"Sending alert for commercial break starting in * 
i + * seconds, lasting " + duration ♦ " seconds") ; 

DatagramPacket dp - new DatagramPacket 

(buffer, pLength, rnGroup, mPort) ; 

ms. send (dp) ; 

Thread- sleep (1000) ; 



public void leave () ( 

try { ms . leaveGroup (rnGroup) ; > 
catch (Exception e) ( 

e .printStackTrace < ) ; 

) 



Thread. sleep (100 0) ; 



) catch (Exception e) { 

e .printStackTrace () ; 
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import java.io.*; 
import java.util-*; 
import java.lang.*; 
import java.text.*; 

public class Schedule extends Thread { 

private String ImAddress; 

private Marconi marconi; 

public static String scheduleFile; 

public static int[) dateArray » new int(4]; 



Tnu Jurwn x- :15:3« 1399 



public Schedule (String [J command, Marconi m) { 
ImAddress « command [01; 
scheduleFile » command [ 1 ] ; 
marconi ■ m; 



public void run () ( 
try < 

byte (3 requestPJct; 
boolean flag; 



while (true) < 

Buf f eredReader br =■ new Buff eredReader (new FileReader (scheduleFile) ) ; 

int[] array - new int (8); 
String str; 

while ((str - br . readLine () ) !- null) ( 
int index » 0; 
for (int i-0; i<8; i++> ( 

int endlndex «■ str . indexOf {' index); 

array [i] - Integer .parselnt (str . substring (index, endlndex)); 
index = endlndex+l; 

> 

String fileName = str. substring (index, atr. length () -1) ; 
getCur rent Date ( ) ; 

if (isBetween (array) ) { 
// start playing 

if (isAddress (fileName) ) flag - false; 
else flag — true; 

System. out , print In ("fileName: "+f ileName) ; 
if (flag) 

requestPkt - marconi • encodeRequest ( (byte) 4, null, ImAddress, fileName); 
else 

requestPkt - marconi .encodeRequest ( (byte) 1, fileName, ImAddress, null); 

marconi . sendRequeat ( requestPkt ) ; 

/* Syst em. out .print In. ("now in date range: - ); 

for (int i-0; i<8; i++) ( 

System. out .print (array (i] + • ") ; 

> 

System. out. printing) ; 
if (flag) 

System. out .println ("Playing file "+f ileName) ; 
else 

System, out .println ("Redirecting packets from "+f ileName) ; */ 



while (true) ( 

Thread. sleep (1000) ; 
getCurrentDateO ; 
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if (!isBetwe € n (array)) break; 

) 

// stop playing 

requestPkt ~ marconi . encodeRequest ( (byte) 2, null, LmAddress, null); 
marconi - sendRequest < requestPkt ) ; 
) // if 

. ) 

} //while 

> 

catch (Exception e) { 

Sy stem. out .println <e. get Message () ) ; 

} ' 

} 

public boolean isAddress (String str) ( 
int count«0; 
int index-0; 

while ( (index=str.indexOf (' , index)) !» -1) i 
count++; 
index++; 

) 

if (count « 3) return true; 
else return falser- 



public static void main (String args [] ) throws Exception ( 

if (args. length !- 1) { 

System, out .print In ("Usage : Schedule <schedule data file>"); 
return; 

) 

String scheduleFile =» args{0); 
while (true) { 

Buf feredReader br = new Buff eredReader (new FileReader (scheduleFile) ) ; 

int[) array - new int [8 J; 
String str; 

while < (str » br . readLine ( ) ) 8- null) i 

int index - 0; 
for (int i-0; i<8; i++) { 

int endlndex - str . indexOf (' ' , index); 

array (i) ■ Integer .parse Int (str. substring (index, endlndex)); 
index - endlndex+l; 

) 

String fileNaroe - str . substring (index, str . length () -1) ; 
String localName - "LOCAL"; 
get Cur rent Date () ; 

if ( isBet ween (array) ) { 
// PLAY 

System, out;, print In ("current time:"); 
for (int i-Oi i<4; i++) ( 

System, out .print (dateAr ray [i] + " "); 

} 

System, out .println ( ) ; 

System. out .print In ("date range:"); 

for (int i-0; i<8; i++) ( 

System, out -print (array (i) + " "); 

) 

System, out .println ( ) ; 

System, out .println ( "Playing file "*fileName) ; 
while (true) ( 

Thread. sleep (1000) ; 
getCurrentDate ( ) ; 
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if (! isBetween (array) ) break; 
> 

// STOP PLAYING 
) // if 
} 

) //while 
J // main 

public static void getCurrentDate ( ) { 
Date myDate - new Date ( ) ; 

Calendar myCalendar - Calendar .get Instance () ; 
dateArray 1 0 J = myCalendar . get (Calendar . DAY__OF_WEEK) ; 
dateArray [1J - myCalendar . get (Calendar . HOUR_OF — DAY) ; 
dateArray [2 J •? myCalendar . get (Calendar .MINUTE) ; 
dateArray (3) =» myCalendar . get (Calendar . SECOND) ; 



public static boolean isBetween (int (] array) { 

for (int i=array[0]; ;i»(i+l)%7) < 
if (i — dateArray [0) ) ( 

if <i i- array[0) i !- array[4]> 

return true; //between 2 days 

if (i arraylO]) { //sometime on the left boundary day 
if (dateArray [11 < array [1]) // if hour is earlier 
return false; 

if (dateArray [1] == array(ll) { // figure out the minutes 
if (dateArray [2] < array(2]) return false; 
if (dateArray (2) — array [2)) 4 // figure out the seconds 
if (dateArray (3] < array [3]) return false; 
if (dateArray [3] — array(3) II array[0] !- array(4J) 
return true; 



else if (dateArray [0J !- array (4]) return true; 

) 

if (i — array(4]> { //sometime on the right boundary day 
if (dateArray II) > array [5 )) // if time is later 
return false; 

else if (dateArray II] < array[53) //has already been checked for early 

return true; 
else { // hours are equal 

if (dateArray [2] < array [6]) return true; 

if (dateArray (21 > array [6]) return false; 

//minutes are equal 

if (dateArray {3} > array (7]) return false; 
.return true* 

} 

) 

break; 

} 

if (i mm array C4)) break; 

) 

return false; 

) 

) // class 



else if (dateArray [01 !- array 14]) return true; 



3NSDOCID: <WO 0079734A1_I_> 



30 



<WO 00/79734 



1PCT7US00/16913 



import java.lang.*; 
import java.utxl.*; 
import j ava . io . * ; 

public class CircBuffer extends Thread ( 
private int maxSize; 
private int current Index; 
private BufferEntryU array; 
private int delay - 100; 

private AudioOutput Stream aos; 

private int seq *=* 0; 



Thu 17 14:15:58 199$ 



private void write (byte [] payload) { 
try < 

aos . write (payload, 0, payload. length) ; 

> 

catch (Exception e) ( 

System. out . print In (e . getMessage ( ) ) ; 

} 

) 

public CircBuffer (int maxBuf f erSize) < 
maxSize « maxBuff erSize; 
current Index ~ 0; 

array - new Buf f erEntry [maxSize] ; 

> 

public void enqueue (BufferEntry be) { 
array [be. seq % maxSize] - be; 



public void incrSeq () { 

seq - (seq — - 32767) ? 0 : seq + 1; 

) 

public void run <) { 
int i; 

aos - new Audi oOut put St ream () ; 

while (true) { 

for (i-0; i<maxSize; i++) { 

if (array [seq % maxSize) !- null) ( 
break.; 

\ 

else incrSeqO ; 

} 

if (i ™ maxSize) < 
continue; 

> 

seq - array [seq % reaxSize] .seq; 
Date date - new DateO; 
long time - date .get Time () ; 

if (array[seq % maxSize] .ts + array [seq % maxSize] .offset + delay < time) { 

System. err. println ("late packet: ts - ■ ♦ arraytseq % maxSize). ts ♦ • current tira 
e - • + time + " offset - ■ + array [seq % maxSize] .of f set) ; 
array [seq % maxSize) — null; 
continue; 

) 
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if (arraytaeq % maxSize] .ta + arrayfaeq % maxSize] .offset > time) { 
incrSeqO ; 

/ /System. out . println ("Packet * + seq + " is too early to play") ; 
continue; 

\ 

System. err .println ("writing packet: seq^" + seq+ " ssrc=* + array {seq % maxSire] 
*■ rc + * ts»" + arraytseq % maxSize] .ts) ; 

write (array [seq % maxSize] .payload) ; 

arraytseq % maxSize] « null; 
Thread. yield() ; 

) // while true 
} // run 
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class BufferEntry { 

public int v, ssrc, ts, seq, length; 
public long offset; 
public bytef] payload; 

) 
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/* 

IRC uses local class promptUser, which takes care of console input/output, 
rt displays a menu, gets user input and displays the return values of 
invoked remote methods - 
•/ 

import jova.utxi.*; 
import java.io.'; 

public class Proi^tOser ( 
static String cowiand; 
static BufieredReader br; 
static Stri-ig rvAddr; 
static Stnnq inAddr; 
static String path; 

/** 

* Display th* r*nu 
*/ 

public static vo»d display!) I 

Systen. ovt . pr .nt In « * \n\r Menu 

System, out .prirtUi'l. play"); 

Systen.out.printinr:. stop"); 

System. 01A .p« .r.tin«M. local play"); 

System, out . pr ;nt 1 n <*Q. avit"); 

System, cut . pr int i * \r Select an option: "); 

} 



// read a nunb«r corr«spondiA9 to user's option and convert it to 
// character 

public static char getlnpjtO { 
char choic« • 
try{ 

br * new Buff eredfteader (new Input St re amReader (System. in) ) ; 
choice - ichar ) br .read <) ; 

) 

catch (Exception e) 4 

System. out .print in <e. getMessage () ) ; 

\ 

return choice; 



public static String I) getPlayCommand ( ) { 
System. out .print <* Enter <M> <I*M>: *); 

try{ 

br • new duf f eredAeader (new InputStreamReader (System. in) ) ; 
command - br . readXine ( ) ; 

} 

catch (Exception •) { 

System. out .println (•. getMessage ( ) ) ; 

} 

^ StringTokenizer at - new StringToJtenirer (command) ; 
int argc - st .countTokens < ) ; 
String [] array - new String [argc) ; 

for (int i~0; Kargc; 

array [ij - 3t . nextToken () ; 
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return array; 



public static String () getLocalPlayCommand < ) { 

System. out .print {"Enter <LM> <SCHEDULE FILE>: ■ ) ; 

try< 

br =■ new Buff eredReader (new inputSt reamReader (System. in) ) ; 
command » br . readLine ( ) ; 



Strang (] array ~ new String (2]; 

St nngTokenizer st = new St ringTokeni zer ( command) ; 

for (xnt i - 0; st .hasMoreTokens () && i < 2; i++) ( 
array (i) ° st . nextToken < ) ; 

) 

return array; 



public static String getStopCommand ( ) ( 
System. out -print ( "Enter <LM>: 

try( 

br «■ new Buff eredReader (new Input St reamReader (System, in) ) ; 
command ■> br . readLine () ; 



catch (Exception e) i 

System. out .print In (e.getMessage () J ; 



catch (Exception e) ( 

System. out . println (e .getMessage () ) ; 



return command; 



3NSDOCID: <WO 007&734A1J_> 
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/* MD5C-C - HSA Data Security, Inc., MD 5 message-digest algorithm 
*/ 

/* Copyright (C) 1991-2, RSA Data Security, Inc. Created 1991. All 
rights reserved. 

License to copy and use this software is granted provided that it 
is identified as the "RSA Data Security, inc. MD5 Message-Digest 
Algorithm - in all material mentioning or referencing this software 
or this function. 

License is also granted to make and use derivative works provided 
that such works are identified as "derived from the RSA Data 
Security, Inc. MD5 Message-Digest Algorithm" in all material 
.mentioning or referencing the derived work. 

RSA Data Security, Inc. makes no representations concerning either 
the merchantability of this software or the suitability of this 
software for any particular purpose. It is provided "as is" 
without express or implied warranty of any kind. 

These notices must be retained in any copies of any part of this 
documentation and/or software. 

♦include "global. h" 
♦include "md5.h" 
finclude <memory.h> 

static char rcsidf] « "$Id: md5c.c,v 1.1 1997/12/17 12:52:36 hgs Exp $"; 

/* Constants for MDSTransform routine. 
*/ 



♦define 


Sll 


1 


♦define 


S12 


12 


•define 


S13 


17 


♦define 


S14 


22 


♦define 


S21 


5 


♦define 


S22 


9 


♦define 


S23 


14 


♦define 


S24 


20 


♦define 


S31 


4 


♦define 


S32 


11 


♦define 


S33 


16 


♦define 


S34 


23 


♦define 


S41 


6 


♦define 


S42 


10 


♦define 


S43 


15 


♦define 


S44 


21 



static void MD5Tran3form PROTO_ LIST { (UINT4 (4), unsigned char [64))); 
static void Encode P ROTO^ L 1ST 

({unsigned char *, UINT4 *, unsigned int)); 
static void Decode PROTO_tIST 

( (UINT4 *, unsigned char *, unsigned int))? 

static unsigned char PADDING (64] - < 

0x80, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 r 
0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0. 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 
0, 0, 0, 0, 0, 0, 0, 0, 0, 0 r 0, 0, 0, 0, 0, 0, 0, 0, 0 

>; 

/* F, G, H and I are basic MD5 functions. 
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*/ 

♦define F(x, y# z > < < <x> & (y) ) I ( <-*) & <z))) 

Idefine G<x, y, z) < <<x> & ( Z )> | ( (y) 4 <-z))> 

♦define H(x, y, z) < (x) * ( y ) A (z|) 

♦define X (x, y, z) < <y) * ( (x) I <~z) ) ) 

/* ROTATE_LEFT rotates x left n bits. 
*/ 

♦ define ROTATE_LEFT <x, n) { ( <x) « (n) ) I l(x) » <32-<n)))) 

/* FF, GG, HH, and II transformations for rounds 1, 2, 3, and 4. 
Rotation is separate from addition to prevent recomputat ion . 
•/ 

♦define FF(a, b, c, d, x, s, ac) < \ 
(a) +*= F <<b), <c), td)) + (x) + (UINT4)(ac); \ 
(a) - ROTATE — LEFT ((a), (a)); \ 
(a) (b); \ 

> 

♦define GG(a, b, c, d, x, s, ac) ( \ 
(a) G (<b), <c), <d>) ♦ <x) + (UINT4)(ac); \ 

(a) - ROTATE_LEFT < (a) , (S)); \ 
(a) (b); \ 

) 

♦define HH(a, b, c, d, x, s, ac) { \ 
(a) H ((b), (c>, (d)) * <x) + (UINT4)(ac); \ 

(a) - ROTATE_LEFT ( (a) , (a)); \ 
(a) (b); \ 

} 

♦define II (a, b, c, d, x, 3, ac) ( \ •* 
(a) I ((b), <c), (d)) + (x) + <UINT4)(ac); \ 

(a) = ROTATE.LEFT ((a), (3)); \ 
(a) +- (b); \ 
> 

/* MD5 initialization. Begins an MD5 operation, writing a new context. 
*/ 

void MD5Init (context) 

MD5_CTX * context; /* context */ 

( 

context->count [0] - con text'-> count [1] - 0; 
/* Load magic initialization constants. 

context->state[0] - 0x67452301; 
context->state[l] « 0xefcdab89; 
context->state [2) - 0x98badcfe; 
context->state[3) - 0x10325476; 

) 

/* MD5 block update operation. Continues an MD5 message-digest 
operation, processing another message block, and updating the 
context . 
V 

void MD 5 Update (context , input, inputLen) 

MD5_CTX *context; /* context */ 

unsigned char * input; /* input block */ 

unsigned int inputLen; /* length of input block */ 

{ 

unsigned int i, index, partLen; 

/* Compute number of bytes mod 64 */ 

index • (unsigned int) ( (context->count (0] » 3) 4 0x3F) $ 
/* Update number of bits */ 

if ( <context->count(0] +• < (UINT4) inputLen « 3)) < ( (UINT4) inputLen « 3) ) 
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context->count [1] ++; 
context->count [1) +=- ( (UINT4) inputLen » 29); 

partLen - 64 - index; 

/* Transform as many times as possible. */ 
if (inputLen >= partLen) ( 
menicpy 

t (POINTER) &context->buffer [index] , (POINTER) input, partLen) ; 
MDSTransform <context->state, context->buf f er i ; 

for U - partLen; i + 63 < inputLen; i +*» 64) 
MDSTranaf orm { con text ->st ate, &input[i]); 

index — 0 ; 

) 

el se 

1 - C; 

/ • Buffer renaming input */ 
nemcpy 

( (POINTER) « context ->buf fer ! index] , (POINTER) fiinput [il , 
mputLen-i) ; 

) 

/♦ MD5 f inaLization. Ends an MD5 message-digest operation, writing the 
the message digest and zercning the context. 
*/ 

void MDSFinal (digest, context) 

unsigned char digest [161; /* message digest */ 

MD5 — CTX •context; /* context */ 

( 

unsigned char bits [8]; 
unsigned int index, padLen; 

/* Save number of bits */ 

Encode (bits, context->count , 8); 

/* Pad out to 56 mod 64 . */ 

index - (unsigned int ) ( (context->count [0] >> 3) & 0x3f ) ; 
padLen » (index < 56) 7 (56 - index) : (120 - index); 
MD 5 Update (context, PADDING, padLen) ; 

/* Append length (before padding) */ 
MDSUpdate (context, bits, 8); 

/* Store state in digest */ 

Encode (digest, context->state, 16); 

/* Zeroize sensitive information. */ 
memset ( (POINTER) context , 0, sizeof (*context)); 
} /* MDSfinal */ 



/* MD5 basic transformation. Transforms state based on block, 
*/ 

static void MD5Transform (state, block) 
(J I NT 4 state [4); 
unsigned char block 1 64] ; 

i 

UINT4 a - state[01, b - state[l), c - state(2], d - state[3], x[16]; 
Decode <x, block, 64) ; . 
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/* 


Round 


a * 


/ 
















FF 


(a, 


br 


c, 


dr 


X i 


0)/ 


Sllr 


0xd76aa478) ; 


/" 


1 * 


/ 


FF 


<d, 


a. 


br 


Cr 


X i 


1] , 


S12, 


0xe8c7b756> ; 


/* 


2 * 


/ 


FF 


<c. 


dr 


a, 


b, 


X 1 


2] 0 


S13, 


0x242070db) ; 


/* 


3 * 


/ 


FF 


<D, 


c, 


d, 


a, 


X 


3] r 


S14, 


Oxclbdceee) ; 


/* 


4 * 


/ 


FF 


<a, 


b. 


c , 


dr 


X 


4] r 


Sll, 


Oxf 57c0£a£) ; 


/* 


5 * 


/ 


FF 


<d, 


a, 


b, 


Cr 


X 


5]r 


S12, 


0x4787c62a) ; 


/* 


6 * 


/ 


FF 


<c, 


dr 


a. 


br 


X 


6J, 


S13, 


0xa8304613); 


/• 


7 * 


/ 


FF 


<b, 


c, 


d, 


a, 


X 


7], 


S14, 


0xfd469501) ; 


/* 


8 * 


/ 


FF 


(a, 


b, 


c, 


dr 


X 


8], 


Sll, 


0x698098d8) ; 


/* 


9 * 


/ 


FF 


<d, 


a, 


b, 


C, 


X 


9)r 


S12, 


0x8b44f 7a£) ; 


/* 


10 


*/ 


FF 


(c, 


d, 


a, 


b, 


X 


10], 


S13, 


Oxff f £5bbl) ; 


/* 


11 


*/ 


FF 


<b, 


c, 


d f 


a, 


X 


11), 


S14, 


0x895cd7be) ; 


/* 


12 




FF 


(a, 


b, 


Cr 


dr 


X 


12]r 


Sll, 


0x6b901122) ; 


/* 


13 


•/ 


FF 


<d. 


a, 


b, 


Cr 


X 


13], 


S12, 


0xfd987193) i 


/* 


14 


*/ 


FF 


(Ci 


d. 


a. 


b, 


X 


14], 


S13, 


0xa679438e) ; 


/* 


15 


*/ 


FF 


{b ( 


c, 


d. 


a, 


X 


15], 


S14, 


0x49b40821) ; 


/* 


16 


V 


/ # 


Round 


2 * 


/ 
















GG 


<a, 


b. 


c, 


d p 


X 


1], 


S21, 


0xf61e2562) ; 


/• 


17 


*/ 


GG 


<d. 


a, 


b, 


Cr 


X 


6], 


S22, 


0xc040b340) ? 


/• 


18 


•/ 


GG 


<c, 


d, 


a, 


b, 


X 


11]/ 


S23r 


0x265e5a51) ; 


/• 


19 


*/ 


GG 


<b, 


c, 


d, 


a, 


X 1 


0], 


S24, 


0xe9b€c7aa) ; 


/• 


20 


*/ 


GG 


(a, 


b. 


c # 


d. 


x 1 


5] , 


321, 


0xd62fl05d) ? 


/ * 


21 


*/ 


GG 


<d, 


a, 


b, 


c 


X 


lOJr 


S22, 


0x2441453) ; 


/* 


22 


V 


GG 


(c ( 


d, 


a, 


br 


X 1 


15], 


S23, 


0xd8ale681) ; 


/• 


23 


*/ 


GG 


<b, 


c, 


d f 


a, 


X 1 


4], 


S24, 


0xe7d3fbc8) ; 


/* 


24 


V 


GG 


<a, 


b, 


c, 


dr 


x ! 


9]r 


321, 


0x21elcde6) ; 


/* 


25 


*/ 


GG 


<d, 


a. 


br 


c, 


X 


14], 


S22r 


0xc33707d6); 


/* 


26 


V 


GG 


<c, 


d. 


a f 


br 


X 


3], 


S23, 


Oxf 4d50d87) ; 


/* 


27 


V 


GG 


<b, 


c, 


dr 


a. 


X 


8], 


S24, 


0x4S5al4ed, ; 


/* 


28 


*/ 


GG 


(a, 


b. 


c. 


dr 


X 


13], 


S21, 


0xa9e3e905> ; 


/* 


29 


*/ 


GG 


<d, 


a, 


br 


Cr 


X 


2], 


S22, 


0xfcefa3f 8) ; 


/* 


30 


V 


GG 


(c, 


d, 


a # 


br 


X 


, 7], 


S23, 


0x676f02d9>; 


/* 


31 


*/ 


GG 


<b, 


c, 


d, 


a. 


X 


12], 


S24, 


0x8d2a4c8a) ; 


/* 


32 


*/ 


/* 


Round 


3 * 


















HH 


(a. 


b. 


Cr 


d. 


X 


l 53, 


S31, 


0xf££a3942) ; 


/* 


33 


*/ 


HH 


<d. 


a, 


b, 


c. 


X 


[ 8], 


S32r 


0x8771f681>; 


/* 


34 


*/ 


HH 


(c, 


d, 


a, 


b. 


X 


11], 


S33, 


0x6d9d6122) ; 


/* 


35 


*/ 


HH 


<b, 


c, 


dr 


ar 


X 


[14], 


S34r 


0xfdeS38Oc) ; 


/* 


36 


*/ 


HH 


(a, 


b, 


c * 


d. 


x 


L ■* J / 


S31 - 


V ~ ^* ^ ^ / 0 


/* 


37 


*/ 


HH 


(d. 


a# 


b, 


Cr 


X 


[ 43, 


S32, 


0x4bdec£a9) ; 


/* 


38 


*/ 


HH 


(c r 


d, 


a, 


br 


X 


[ 7], 


S33, 


0x£€bb4b60); 


/* 


39 


*/ 


HH 




c. 


dr 


a. 


X 


[10], 


S34, 


0xbeb£bc70) ; 


/* 


40 


*/ 


HH 


(a, 


b, 


Cr 


dr 


X 


[13], 


S31, 


0x28 9b7ec6) ; 


/• 


41 


V 


HH 


<d. 


a, 


br 


C f 


X 


[ OJr 


S32, 


0xeaal27fa) ; 


/* 


42 


*/ 


HH 


(c. 


d, 


a. 


b. 


X 


[ 3], 


S33, 


0xd4e£3085) ; 


/* 


43 


*/ 


HH 


<b. 


C f 


d # 


a r 


X 


[ 6], 


S34, 


0x4881d05) ; 


/* 


44 


*/ 


HH 


(a. 


b, 


Cr 


d. 


X 


[ 9], 


S31, 


0xd9d4d039) ; 


/• 


45 


*/ 


HH 


(d. 


a, 


br 


c, 


X 


[12], 


S32, 


0xe6db99e5) ; 


/* 


46 


*/ 


HH 


(c. 


d. 


a. 


br 


X 


[15] , 


S33, 


0xl£a27c£8) ; 


/* 


47 


*/ 


HH 


(b. 


c, 


dr 


a. 


X 


[ 2], 


S34 r 


0xc4ac5665) ; 


/* 


48 


*/ 


/* 


Round 


4 « 


















II 


(a. 


b. 


c, 


dr 


X 


[ 0], 


S41r 


Oxf 4292244); 


/• 


49 


V 


II 


<d. 


a, 


b, 


Cr 


X 


t 7), 


S42, 


0x432a££97); 


/* 


50 


V 


II 


<c, 


d, 


a« 


br 


X 


[14], 


S43, 


0xab9423a7); 


/* 


51 


V 


II 


<br 


Cr 


d, 


ar 


X 


E 5], 


S44, 


0xfc93a039); 


/• 


52 


V 


II 


(a. 


far 


c. 


dr 


X 


[12]r 


S41, 


0x655b59c3>; 


/* 


53 


*/ 


II 


<d, 


a, 


br 


Cr 


X 


[ 3] r 


S42, 


0xBf0ccc92) ; 


/* 


54 


*/ 


IX 


<c. 


d. 


a, 


br 


X 


[10], 


S43, 


Oxffeff 47d) ; 


/* 


55 


*/ 


II 


<b. 


Cr 


dr 


a. 


X 


[ 11, 


S44, 


0x85845ddl); 


/* 


56 


*/ 



39 

■NSDOCID: <WO 0079734 A 1_l_> 



1 > 



WO 00/79734 PCT/US00/16913 



ndSc.c 






tfun 17 


14^:51 L999 




5 




II (a, b. 


e, 


d. 


x[ 8] , 


S41, 0x6fa87e4f ) ; 


/* 


57 


•/ 


T T t M •» 

1 1 t<l| a, 


D r 


C r 


x r i s i 




/ * 

/ 


58 


♦ / 




a r 


b, 


x( 6] , 


S43, 0xa3014314); 


/ * 


59 


*/ 


II <b, c. 


d, 


a, 


x[133 , 


S44, 0x4e08llal) ; 


/* 


60 


*/ 


II (a, b. 


c, 


d, 


x{ 4}. 


S41, 0xf7537e82> ; 


/• 


61 


*/ 


II <d, a, 


b, 


c. 


x[ll] , 


S42, 0xbd3af235) ; 


/* 


62 


*/ 


II <c, d, 


a # 


b, 


x[ 2), 


S43, 0x2ad7d2bb) ; 


/• 


63 


*/ 


II (b, c. 


d. 


a, 


x[ 9], 


S44, 0xeb8€d391) ; 


/* 


64 


*/ 


statefO] 




a; 












state ( 1 ] 




b; 













state[2] +■= c; 
state(3] +« d; 

/* Zeroize sensitive information. */ 
memset ( (POINTER) x, 0, sizeof <x) ) ; 

> 

/* ■ 

* Encodes input (UINT4) into output {unsigned char). Assumes len is 

* a multiple of 4. 
V 

static void Encode (output, input, len) 

unsigned char *output; 

UINT4 * input; 

unsigned int len; 

< 

unsigned int i, j; 

for (i - 0, j - 0; j < len; i++, j 4) { 
outputfj] • (unsigned char) (input ( i] 6 Oxf f ) ; 
output[j+l] = (unsigned char) < (input [i] >> 8) & Oxf f ) ; 
outputlj+2] - (unsigned char )( (input [i] » 16) & Oxf f ) ; 
output[j+3] - (unsigned char) ( (input Ci] 24) & Oxf f ) ; 

) 

) 

/* 

* Decodes input (unsigned char) into output (UINT4) . Assumes len is 

* a multiple of 4 . 
V 

static void Decode (output, input, len) 
UINT4 *output; 
unsigned char * input; 
unsigned int len; 

{ 

unsigned int i, j; 

for (i =» 0, j - 0; j. < len; j +- 4) 

outputli] - ((UINT4) input (j)) I (( (UINT4) input ( j + 1 ) ) « 8) | 
(( (UINT4) input (j+2] ) « 16> I (( (UINT4) input ( j*3) ) « 24); 

\ 
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Generate a random 32-bit quant: 



r&ndcm32 . c 

/ 



*/ 

♦ include oys/tine . h> 
♦include <unistd.h> 
♦include <string.h> 

♦ include <stdlib.h> 
♦include <stdio.h> 
♦include <sys/utsnarae .h> 
♦include <time.h> 
♦include "global. h" 

♦ include "rnd5.h" 



:ity . 

/* gettimeofday <) */ 

/* get. . O */ 

/* atrncpyt) */ 

/* atoiO */ 

/* printf () •/ 

/* unaneO */ 

/* clock (> */ 

/* from RFC 1321 */ 

/* from RFC 1321 */ 



sxtern long get host id (void) ; 

static char rcsidU - "$Id: random32.c,v 1.2 1998/09/29 16:31:37 hgs Exp $" 

♦ define MD__CTX MD5„CTX 
♦define MDInit MD5Init 
I define MDUpdate MDSUpdate 
♦define MDFinal MDSFinal 
typedef unsigned long u_int32; 

static u_int32 md_32 (char *string, int length) 
{ 

md_ctx context; 
union { 

char c[16]; 

u_int32 x[4]; 
> digest; 
u_int32 r; 
int i; 

MDInit (^context); 

MDUpdate (^context, (unsigned char *) string, length); 
MDFinal ((unsigned char *)4digest, ^context); 
/* XOR the four parts into one word */ 
for (i - 0, r - 0; i < 3; i++) r A - digest. x[i]; 
return r; 
> /* md_32 */ 



* Return random unsigned 32-bit quantity. 
*/ 

uint32_t random32(int type) 



{ 



struct { 

int type; 

struct timeval tvj 

clocx_t cpu; 

picL-t pid; 

u_long hid; 

uidL-t uid; 

gidL.t gid; 

struct utsnarae name; 
> 3; 

gettimeof day (is. tv, 0) ; 
s. type - type; 
s.cpu - clock 0 ? 
s.pid « getpidO ; 
s. hid - gethostidO; 
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3 .uid - getuid < ) ; 
s.gid - getgidO; 
uname ( & 3 . name ) ; 

return md_32(<char *)« 3 , aizeoffs)); 
> /* random32 */ 
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AudioOutputStx«a»- j* va 

import java . io . •; 
import java . ut il .Date; 

/** 

* An audio cutout stream is an output stream for writing data to a 

* (possible dummy) audio device. 

* <p> 

* The streari records performance statistics, such as the milliseconds of 

* "dead air*. • the number of writes that were late, etc. Statistics are 

* kept following the first write () invocation. 

* <p> 

* For accuracy* trs« class keeps statistics internally in microseconds, 

* but exports tr;e» ir. milliseconds. 

* <P> 

* On architectural supporting the " /dev/audio" device file (Solaris, Linux), 

* the AudioOutput St rt«n will Also write the data to the audio device. 

* Qauthor Alenarder V. KorjtAPtinou 

* Gversion SBevxaicn; 1.5 * 
*/ 

public class Ajc;o^-t put St tm fitends OutputStream { 
/♦* 

* microsecond p«r ryte for • KHz, 8-bit MLAW samples 
*/ 

public static f*na; long »spto_3KHz__8bit_ MLAW - 125; 

private long expirttHicroi; 
private long microsPer Byte; 
private long nisitcMicrou 
private long l*t«nritti; 

private FileOutput St re** fast ream » null; 

* Create new Audi oOut put St team with default encoding 8 KHz, 8-bit MLAW 

* <p> 

* On architectures supporting a "/dev/audio* device file, the constructor 

* will attempt to op«n the device for writing (but will not fail if 

* this is refused I . 
*/ 

public AudioOutputStre«i»(> i 
super ( ) ; 

microsPerByte - mspto_BKHr_8bit_MLAW; 

// Try to open the /dev/audio device file 
try { 

f 03 1 ream » new F i leOu t put Stream ( Vdev/audio" ) ; 
} catch (Exception • > I 

System. err .printlA (*!!!!!!! Can't open /dev/audio !!!!!!!!!•); 
fo st ream — null; 

) 

} 

/•• 

* Create new AudioOutputSt ream for an unknown encoding which 

* expands a byte of data to •microsecondsPerByte" <B>micro</B> seconds 

* <p> 

* Note that the value is in <B>microseconds<B>, not, milliseconds, 

* <P> 

* No attempt will be made to open the "/dev/audio" device file due 

* to the unknown format. 
*/ 

public AudioOutputStreamdong microsecondsPerByte) i 
super () ; 
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AudioChrtputStroaa- Thu Jun XI 14:17:38 1999 

microsPerByte = microsecondsPerByte; 

foatream =* null; // unlcown encoding is not written to audio device 

) 

/** 

* Resets audio play statistics 
*/ 

public void resetStatsO ( 
expiresMicros - 0; 
missedMicros * 0; 
latewrites 53 0; 

} 

/•* 

* Updates statistics for "count" bytes were buffered for audio output 
V 

private void logWriteBytes ( int count) { 

long currentMicroa - System. currentTimeMillis ( ) * 1000; 
if (currentMicros > expiresMicros) ( 
if (expiresMicros > 0) ( 

missedMicros +» currentMicros - expiresMicros; 
♦ ■t-lateWritesj 

} 

expiresMicros - currentMicros +■ count * microsPerByte; 
} else { 

expiresMicros count * microsPerByte; 

> 

) 

/** 

* Writes the specified byte to the audio device. 

* Use of this method is discouraged, as the overhead for obtaining 

* the current time will be significant compared to the play time 

* for one byte. 
V 

public void write (int b) throws IOException { 
logwri t eBytes ( 1 ) ; 

if (fostream null) f ostream. write (b) ; 

> 

/** 

* Writes b. length bytes from the specified byte array to the audio 

* device. 

* Avoid very small byte arrays for the same reason as write (int b) . 
*/ 

public void write (byte b[]) throws IOException { 
logWriteBytes (b. length) ; 

if (fostrean 1- null) fostream. write (b) ; 

> 

/** 

* Writes len bytes from the specified byte array starting at offset off 

* to the audio device. 
* 

* Avoid very small lengths (len) for the same reason as write (int b) . 
V 

public void write (byte b[), int off, int len) throws IOException { 
logWriteBytes (len) ; 

if (fostream !- null) f ostream. write (b) ; 

) 

/** 
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* Flushes this output atreara and forces any buffered output bytea to 

* be written out. Currently a no-op (does nothing). 
*/ 

public void flush () throws IOException { 
> 

* Closes this output stream and releases any system resources associated 

* with this stream. 

public void close O throws TOException { 
resetStats () ; 
if {fostream ! =* null) { 

fostream. close < ) ; 

fostream =» null; 

} 

} 

/** 

* Returns the number of milliseconds of "dead air" up to the last 

* write. 
* 

* Succesive invocations of this method without other intervening 

* AudioOutputStream method invocations will return the same value. 
*/ 

public long getMissedMillisAtLastWrite ( ) < 
return (misaedMicros / 1000); 

} 

# * 

* Returns the number of milliseconds of "dead air" accumulated so far. 

* Succesive invocations of this method may not return the same value if 

* there is no buffered data for output, as this method returns the 

* total so far (current time) . 
*/ 

public long getMissedMillis ( ) { 

long currentMicros - System. currentTimeMillis ( ) * 1000; 

if (currentMicros > expiresMicros) { 

if (expiresMicros ™ 0) // special case - no writes so far 

return 0; 
else 

return! (missedMicros «■ (currentMicros - expiresMicros)) / 1000); 
) else i 

return (missedMicros/1000) ; 

> 

> 

/ * * 

* Returns the number of late writes counted so far 
*/ 

public long getLateWritaCount ( ) i 
return UateWrites) ; 

> 

* Returns the expiration time in milliseconds of the current audio 

* playing. 
* 

* If no audio is currently buffered, will return the time 

* when the last byte completed playing. 

* Time is represented as microseconds between the current time and 

* midnight, January 1, 1970 UTC. This measure is system dependent. 
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* Flushes this output stream and forces any buffered output bytes to 

* be written out. CurrentLy a no-op (does nothing). 
*/ 

public void flush () throws IOException { 
} 

/*• 

* Closes this output stream and releases any system resources associated 

* with this streare. 

public void dosed throws IOException < 
resetStatsO; 
if (fostrean *- n-jll) { 

fostreajv.cl39tU ; 

fostream • null; 

} 

) 

/** 

* Returns the nuAUr of milliseconds of "dead air" up to the last 

* write. 
* 

* Succesive invocations of this method without other intervening 

* AudioOutput St t**m Mthod invocations will return the same value. 
*/ 

public long getMi • i«dMi 1 1 i sAt Last write ( ) { 
return (missedHicroa / lOCCl: 

} 

/** t i 

* Returns the nv«Mr of milliseconds of "dead air* accumulated so far. 
• 

* Succesive invocation* of this method may not return the same value if 

* there is no buffered data fcr output, as this method returns the 

* total so far (current tint) . 

V 

public long getMisseCHxllis O < 

long currentMicros • System. currentTimeMillis ( ) * 1000; 

if (currentMicros > •ipir«5Micros) { 

if (expiresMicrcs — 0) // special case - no writes so far 

return 0; 
else 

return ( (missedMicros ♦ (currentMicroa - expx resMicros) ) / 1000); 
} else < 

return (missedMicros/ 1000) ; 

} 

> 

/** 

* Returns the number of late writes counted so far 
*/ 

public long getI*ateWrite€ount ( ) { 
return ( lateWr ites ) ; 

) 

/** 

* Returns the expiration tine in milliseconds of the current audio 

* playing. 
* 

* If no audio is currently buffered, will return the time 

* when the last byte completed playing. 

* Time is represented as microseconds between the current time and 

* midnight, January 1, 1970 UTC. This measure is system dependent, 
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long sleepMillis 




LisO) * Math. random () ) ; 

if (sleepMillis > 0) < 

System. out .println ("Sleeping for • -t- sleepMillis + " ...*); 
Thread. sleep (sleepMillis) ; 

) 

} while (n != -1); 

a os .print 5 tats ( ) ; 
aos .close t ) ; 
) catch (Exception e) ( 
c . pnntStacicTrace ( ) ; 



\ JI class AjcioOutputStream 



r T 
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import java.awt.*? 
import java.io.*; 

public class TextEdit extends Frame ( 

public TextEdit (String [] commandArray, Marconi m) { 
this.m =» m; 

this .commandAr ray » commandArray; 

setTitle ("TextEdit*) ; 

Panel pi » new Panel O ; 

pi . setLayout (new FlowLayout ( ) ) ; 

pl.addtnew Label ( "filename : ")); 

filename = new Text Fie Id (commandArray [ 1 J , 20); 

pi . add ( filename) ; 

add ("Center" r pi); 

Panel p2 = new Panel <); 

p2 . setLayout (new FlowLayout ()) ; 

p2 .add (createButton =» new Button ("Create")); 

p2 .add ( f inishButton =» new Button ("Finish")); 

add ("South", p2); 

) 



public boolean handleEvent (Event event) { 

if (event, id — Event . ACTION_EVENT event, target — createButton) ( 
String fname - f ilename .getText ( ) ; 
if ( f name . equals ("") ) return true; 
/* boolean flag » false; 

try { 

Buf feredReader br «- new Buf f eredReader (new Fi le Reader ( f name) ) ; 

> 

catch (FileNotFoundException e) { 
flag - true; 

y 

if (!flag> < 

System. out .println ("file "*fnarae+" already exists*); 
return true; 
> */ 

Frame ne m new New Ed it (fname, this) ; 
ne. resize (200, 150); 
this .hide <) ; 
ne. show ( > ; 
return true; 

> 

if (event, id == Event .ACT ION_EVENT && event.target ~ finishButton) < 
dispose () ; 

m.sendSchedule (commandArray, Thread, cur rent Thread ( ) ) ; 
Thread . currentThread ( ) . suspend ( ) ; 
return true; 

) 

return super .handleEvent (event) ; 

) 

/* 

public static void main (String [ J args) ( 
String [1 str - new String (]; 
Frame f - new TextEdit <str) ; 
f . setSize (300, 150) ; 
f . show ( ) ; 

) 

*/ 

private TextField filename; 

private Button createButton, f inishButton; 

private String [] commandArray; 



48 



3NSDOCID: <WO 0079734A1 J_> 



WO 00/79734 PCT/US00/16913 
T.*ttdi*.j.™ n 17 14:18:26 1999 2 PC'^OS 00/ IS 9 13 

private Marconi m; 



49 



iMSDOCID: <WO 0079734A1J_> 



WO 00/79734 PCT/US00/16913 
Ich^dule. jav* *bu Jvx^p 14 18:49 1999 1 



.mport java.io.*; 

.mport java.util.' 

.mport java.lang.' 

.mport java.text. 4 

>ublic class Schedule extends Thread 1 

private String ImAddress; 

private Marconi marconi; 

Public static String scheduleFile; 

Jublxc sutic incll dateArray = new int [4]; 

sublic Schedule (String (] command, Marconi m) ( 
ImAddress - command(O); 
scheduleFile - command {11; 
marconi - ft; 



Public void runo i 
try { 

bytefl requestPkt; 
boolean flag; 



while (true) i 

Buf feredReader br - new Buff eredReader < new FileReader (scheduleFile) ) ; 

mtCJ array - new int (8); 
String atr; 

while ((str - br . readLine < ) ) !- null) ( 
int index - 0; 

StringTokenizer at - new StringTokenirer (str, 9 
for unt 1-0; i<8; i+*) \ 
/• int endlndex - str . indexOf ( ' index); 
array (il - Integer . parselnt (str . substring (index, endlndex)); 
index - endlndex+l; */ 

array [1] - Integer . parselnt (st . nextToxen () ) ; 

) 

// String fileName - str . substring (index) ; 

String fileName - st . nextToken ( ) ; 
getCurrentDat e ( ) ; 

if (isBetveen (array) ) { 
// start playing 

if (ia Address (fileName) ) flag - false; 
else flag - true; 

System. out .println ("fileName: " + fileName) ; 
if (flag) 

requestPkt. " marconi .encodeRequest ( (byte* 4, null, ImAddress, fileName); 
else 

request Pkt marconi -encode Request ( (byte) 1. fileName, ImAddress, null); 

marconi . sendRequeat (requeatPkt) ; 

/* System. out .println ("now in date range:"); 

for (int i-0; i<8; i++J { 

Syst em. out .print (array [i] + • "); 

} 

System, out . println ( ) ; 
if (flag) 

System. out .println ("Playing file "+f ileName) ; 
else 

System. out .println ("Redirecting packets from •♦fileName); */ 
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while (true) { 

Thread. sleep (1000) ; 

getCurrentDate < ) ; 

if <t isBetween (array) ) break; 

} 

// stop playing 

requestPkt « rnarconi . encodeRequest ( (byte) 2, null, ImAddress, null); 
rnarconi. sendRequest (requestPkt) ; 
) // if 

) 

} //while 

) 

catch (Exception e) { 
e . printStackTrace ( ) ; 

) 

) 

public boolean isAddress (String str) { 
int count-0; 
int index^O; 

while ( ( index^str . indexOf (' . ' , index)) !- -1) { 
countff; 
index-*--*-; 

> 

if (count ™ 3) return true; 
else return false; 

) 

public static void main (String args [ ] ) throws Exception ( *^ 
try < r r 
if (args. length !- 1) ( 

System. out .println ("Usage : Schedule Ochedule data file>"); 

return; 

\ 

String scheduleFile - args(O); 
while (true) < 

Buf f eredReader br « new Buff eredReader (new FileReader (scheduleFile) ) ; 

int[] array — new int [8]; 
String str; 

while ((str - br . readLine ( ) ) !- null) ( 

int index — 0; 
for (int i-0; i<8; i*+) { 

int endlndex - str . indexOf (' index); 

array [i] - Integer. parselnt (str .substring (index, endlndex)); 
index - endlndex+l; 

) 

String fileName - str .substring (index) ; 
String localNarae - "LOCAL"; 
getCurrentDate ( ) i 

if ( isBet ween (array) ) < 
// PLAY 

System. out .print In ("current time:"); 
for (int i-0; i<4; i++) { 

Sy stem. out .print (dateArray [i] + " •); 

> 

System. out .print In () ; 

System. out .print In ("date range;"); 

foe (int i-0; i<8; i++) { 

System. out .print (array [i) ♦ " "); 

) 

System . out * print In ( ) ; 

System. out .print In ("Playing file •♦fileName) ; 
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while (true) ( 

Thread .sleep < 1000) ; 

getCurrencDate ( ) ; 

if (! isBetween (array) ) break; 

) 

// STOP PLAYING 
} // if 
) 

} //while 
> 

catch (Exception e) { 
e.printStackTrace <) ; 

> 

} // main 

public static void getCurrentDate ( ) ( 
Date myDate « new Date ( ) ; 

Calendar myCalendar M Calendar . get Instance () ; 
dateArray(O) = myCalendar . get (Calendar ,DAY_OF_WEEK) -1 ; 
dateArray [1] *■ myCalendar . get (Calendar . HOUR_OF_DAY) ; 
dateArray(21 = myCalendar . get (Calendar .MINUTE) ; 
dateArray[3] - myCalendar . get (Calendar . SECOND) ; 

1 

public static boolean isBetween ( int ( ] array) { 

for (int i»array(01; ;i=(i+l)%7) < 
if (i — dateArray (0) ) ( 

if (i !» array (0] 66 i !- array [4]) ,» 
return true; //between 2 days , i 

if (i =»=, array (01) ( //sometime on the left boundary day 
if (dateArray [1] < array [1)) // if hour is earlier 
return false; 

if (dateArray[l] =» array [1]) { // figure out the minutes 
if (dateArray [2] < array [2]) return false; 
if (dateArray (21 — array [2)) < // figure out the seconds 
if (dateArray {3] < array [3]) return false; 
if (dateArray[3] — array[3] II array[0] !- array(4]) 
return true; 

\ 

else if (dateArray (0] != array [4]) return true; 

} 

else if (dateArray [0J !- array [4)) return true; 

> 

if (i array(4]) { //sometime on the right boundary day 
if (dateArray (1) > array[5]) // if time is later 
return false; 

else if (dateArray [1] < array (5 J) //has already been checked for early 

return truei 
else { // hours axe equal 

if (dateArray [2] < array [6)) return true; 

if (dateArray 12] > array [6]) return false; 

//minutes are equal 

if (dateArray [3] > array[7]) return false; 
return true; 

> 

} 

break; 

> 

if (i — array (4]) break; 

} 

return false; 
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) // class 
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import java.awt-*; 
import java . io. *; 

public class NewEdit extends Frame { 

public NewEdit (String fileName, Fraine f) < 
this.f =» f? 
try < 

bw = new Buff eredWriter ( new Filewriter (fileName) > ; 

) 

catch (lOException e) { 
System. exit (0) ; 

> 

this . fileName = fileNajne; 

setTitle ( "NewEdit" ) ; 

Panel pi = new Panel (); 

pi . setLayout (new FlowLayout < ) ) ; 

newButton « new Button ("New Entry") ; 

pi . add (newButton) ; 

finishButton - new Button ("Finish"); 
pi . add (finishButton) ; 
add ("Center", pi) ; 



public void processEdit (Edit rnf o info) ( 
String space » " ■? 
try { 

bw. write (info. fromDay, 0, 1); 
bw. write (space* 0, 1); 

bw. write (info, fromfiour, 0, inf b . fromHour. length ()) ; 
bw. write (space, 0, 1); 

bw. write (info. fromMin, 0, inf o . fromMin . length ()) ; 
bw. write (space, 0, 1) ; 

bw. write (inf o.fromSec, 0, info. fromSec. length ()) ; 
bw.write(space, 0, 1) ; 
bw.write(info.toDay, 0, 1); 
bw. write (space, 0, 1) ; 

bw. write (info-toHour, 0, inf o.toHour. length ()) ; 
bw. write(space, 0,1); 

bw. write (info- toMin, 0 f inf o. toMin . length ()) ; 
bw. write (space, 0, 1); 

bw. write (info.toSec, 0, inf o.toSec. length ()) ; 
bw. write (space/ 0/ 1) ; 

bw. write (info. filename, 0, inf o.f ilename. length () ) ; 
bw.newLine () ; 



public boolean handleSvent (Event event) i 

if (event, id — Event .ACT ION_EVENT « event, target newButton) { 
Editlnfo in - new EditTnfoO; 
EditDialog ed - new EditDialog (this, in); 
ed.showU ; 



else if (event. id — Event .ACTION_EVENT && event. target — finishButton) ( 
try { 

bw. close () ; 

) 

catch (lOException e) { 



} 

catch (lOException e) { 
System. exit (0) ; 



> 



dispose () ; 
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f . show ( ) ; 

) 

return true; 

} 

private Button newButton, f inishButton; 
private String fileName; 
private Buf f eredWriter bw; 
private Frame f; 



class Editlnfo i 

String fromDay, toDay, fromHour, toHour, fromMin, toMin, fromSec, 
toSec, filename; 

Editlnfo (String fromDay, String toDay, String fromHour, String toHour, 
String fromMin, String toMin, String fromSec, String toSec, 
String filename) { 

this. fromDay - fromDay; 

this. toDay toDay; 

this . fromHour » fromHour; 

this.toHour = toHour; 

this. fromMin — fromMin; 

this.toMin = toMin; 

this. fromSec » fromSec; 

this.toSec - toSec; 

this . filename «■ filename; 



class Days { 
List days; 
DaysO { 

days - new Listd, false); 

days. addl t era <" 0 : Sun") ; 

days . addl t em < " 1 : Mem" ) ; 

days.addItem("2:Tue") ; 

days, addl t em ("3: Wed") ; 

days . addl t em ( • 4 : Thu" ) ; 

days . addl tern ( " 5 : Fri" ) ; 

days. addl t em (" 6 ; Sat") ; 

days . select (0) ; 



class EditDialog extends Dialog { 

public EditDialog (NewEdit parent, Editlnfo u> < 
super (parent, "Edit Entry", true) ; 
fromDay - new DaysO; 
toDay - new Days(); 
Panel pi new Panel (); 
pi .set Layout (new GridLayout ( 9, 2) ) ; 
pi. add (new Label ("From day:")); 
pi. add (fromDay. days) ; 
pi. add (new Label ("From hour:")); 
pi .add (fromHour * new Text Field (2) ) ; 
pi. add (new Label ("From minute:")); 
pi .add (fromMin - new TextField (2) ) ; 
pi. add (new Label ("From second:*)); 
pi .add (fromSec - new TextField (2) ) ; 
pi. add (new Label ("To day:")); 
pi .add(toDay .days) ; 
pi. add (new Label ("To hour:")); 
pi .add (toHour - new TextField (2) ) ; 



> 



Editlnfo () O 



} 



> 
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pi. add (new Lal>el("To minute:") ); 
pl.additoMin = new TextField (2 ) ) ; 
pi. add (new Label ("To second:*)); 
pl.add(toSec - new TextField (2) ) ; 
pl.add(new Label ( "File/Channel :" ) ) ; 
pi .add (filename =* new TextField*"", 20)); 
CheckboxGroup g - new CheckboxGroup ( ) ; 
Panel p3 ~ new PanelO ; 
p3.setLayout (new FlowLayout < } ) ; 

p3.add(localBox = new Checkbox ("Local ", g, true)); 

p3.add (globalBox *» new Checkbox ( "Global " , g, false)); 

add ("Center", p3) ; 

add ( "North" , pi); 

Panel p2 ~ new Panel (); 

p2.add(okButton = new Button ( "Ok" )) ; 

p2.add (cancelButton « new Button ( "Cancel" )) ; 

add ("South", p2 ) ; 

resize (200, 400); 



public boolean action (Event event, Object arg> { 
if (arg. equals ("Ok") ) ( 

if (fromHour .getText () .equals ("") II toHour . getText () .equals ("" ) 
M f romMin. getText () .equals ("") II toMin. getText (). equals ("") II 
fromSec. getText O .equals ("") I I toSec . getText () -equals {•■) 
I | filename. get Text () .equals ("") ) 
return true; 
try { 

if (Integer .parselnt < f romHour .getText (> ) < 0 I I 



Integer .parselnt (fromHour .getText O ) > 23 I I 
Integer .parselnt (toHour. getText () ) < 0 It 
Integer .parselnt (toHour. getText O ) > 23 I I 
Integer .parselnt (f romMin. getText 0 ) < 0 II 
Integer .parselnt (f romMin -getText () ) > 59 I I 
Integer -parselnt (toMin.get Text () ) < 0 II 
Integer -parselnt (toMin. getText () ) > 59 II 
Integer .parselnt (froraSec.get Text () ) < 0 II 
Integer .parselnt (fromSec -getText () ) > 59 II 
Integer. parselnt (toSec. getText () ) < 0 II 
Integer .parselnt (toSec. getText () ) > 59) 



return true; 

) 

catch (NuraberFormatException e) { 
return true; 

> 

String fnaroe = new String <); 
String str; 
boolean flag - false; 
if (globalBox. getState () ) { 
try < 

BufferedReader fc. - new Buf f eredReader (new FileReader ( "^apsta") ) ; 
while <(str - b.readXine () ) !- null) ( 
int index - 0; 

int endlndex • str . indexOf ( ' index); 

String addr - str .substring (index, endlndex); 

System. out -print In ("str ; *+str . substring (endlndex+l) ) ; 

if ( (str. substring (endlndex+l) ) .compareTo (filename .getText < ) ) —0) { 



fname - addr; 
flag « true; 
break; 



} 

> 

b. close ( ) ; 



) 
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catch (lOException e) (> 
if (Iflag) < 

System. out .pcintln ("Channel name "-♦■filename . getText () +• not found"); 
return true; 

i 

> 

elae fr.a»e • filename. getText <) ; 



♦ tem() , 



Editlrfo result « new Editlnfo ( f romDay . days . getSelectedltem ( ) , toDay , days .getSelected 



f rc*t«our . g*^Text {) , toHour .getText ( ) , f romMin .getText () , 
i3H*n.qttT«xtl), f rornSec. getText t ) , toSec. getText <) , f name) ; 
( (NewEdit. > getParent () ) .processEdit (result) ; 

} 

else if ( ar? .equals < •Cancel") ) { 
dispose ( > ; 

) 

elae return a jp« r . act icr. I «vent , arg); 
return t( ««; 

) 

public txic.ean narvdl* Cvortt ( Event evt) , ( 

if (evt-.d tv«rt «ZNCOW .DESTROY) dispose <); 
else returr vjptr .r .«ndl«Cv«nt (evt) ; 
return trj«; 

1 

private T«*tri«ld frcruiaut, toHour, fromMin, toMin, fromSec, toSec, filename; , r 

private Button o**wtton # cancelButton; 

private Days fro*Day, toCay; 

private Chec*t>oa i oc a . fto« , globalBox; 



57 



BNSDOCID: <WO 0079734A1J_> 



WO 00/79734 PCT/US00/16913 
CKC&cti.onHAndl«r. . un 17 14:21;09 1999 X 

'* marconiNet - Internet Racuo Met work: 
* Distributed Radio Antenna Server (RAS) : I IRC Action Handler] 



* $<marconi -irc.^IB-CActionHandler . java -v2 - 0 (prototype version), 1999/04/21 $ 

* <?jdkl.2, -riK. 
*/ 

package marconi- ire- 
import java . awt . * ; 
import java. awt -event . *; 
import java.util-*; 
impo rt j ava . i o . * ; 

/** 

* This class handles actions taken by IRC user. 
*/ 

public class IRCActionHandler { 

public static ActionListener listControl - new ActionListener!) ( 
public void actionPerf orraed (ActionEvent e) { 
iRCControls .entry_l . setText 

( IRCDirectory .directoryList_l .get Item 
( iRCDirectory . directoryList_l . getSelectedlndex < ) ) ) ; 
String text field = IRCControls . entry_l . getText ( ) ; 
StringTokenizer dir - new StringTokenizer (textf ield, " ") ; 
int id - integer .parselnt (dir. nextloken O ) ; 
if ( IRCDirectory . owner .playChannel (id) ) ( 

System. out .println ("marconi . ire . IRCActionHandler* + 

" .act ionPer formed: playing channel ■ 
+ id + " . ") ; 

) 

else ( 

IRCDirectory .owner. stopChannel 0 ; 

Systenwerr .println ("marconi .ire. IRCActionHandler* + 

" .actionPerformed: error listening."); 

> 

}; 



58 



3NSDCCID: <WO 0079734A1_I_> 



WO 00/79734 PCT/USOO/16913 
»CControls.j«^* THv^ux 1" 14:21:52 1999 1 



/* maxconiNet - internet Radio Metworic 

* Distributed Kadio Antenna Server (RAS ) : URC GUI Controls] 

* $<rnarConi .ire >IRCCont rols . java -v2 . 0 (prototype version), 1999/02/15 $ 
' * 8 jdkl .2, -riK. 

package marconi.irc; 

import java.awt.*; 

import jdva.awt .event .* ; 

import java.util. * ; 

import ^ava.r.et.*; 

import ^ava.io. 

/•• 

* This panel contains user interfaces to the applet. 
•/ 

pufclic Class IRCControls extends Panel { 
public static TextField entry. 1; 
private static int WIDTH » 600; 
private static int HEIGHT = 100; 

/•• 

* Instantiates the control panel. 
•/ 

public IRCCcnt rols ( ) < 

GriciBagLayojt grid - new GridBag Layout () ; 
GricBagtonstraints cons « new GrxdBagConstraint a <) ; 
setLayout (grid) ; 

cons. fill • GrrdBagConst raints . NONE; 
cons.weightx - 0.0; 

// selected station (id + name) 

entry.l • new TextField ( 40) ; 

grid. setConstraints (entry_l, cona) ; 

entry. 1 . setForegrcund (Color . yellow .darker () ) ; 

entry_l . setBackground (Color .blue. darker () .darker () ) ; 

add(entry_l) ; 

validate < ) ; 

// res ire 

setSize (WIDTH, HEIGHT) ; 

) 
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' * marconiNet - Internet Radio Network 

* Distributed Radio Antenna Server ( RAS ) : (IRC Directory Controls! 
* 

* $<mareoni . ras . >IRCDirectory . java -v2 . 0 (prototype version), 1999/04/20 $ 

* Gjdkl.2, -riK. 

>ackage marconi . ire; 

.mport java . awt ♦ *; 
-mport java . awt . event . *; 
.mport java . util .Hashtable; 
.mport java . net . *; 
import java.io.*; 

L mport marconi . ras .MarconiServer; 
.mport marconi . util . CDPPacket; 



* This panel contains user interfaces to the applet. 
*/ 

public class IRCDirectory extends Panel 
implements Runnable { 

/** 

* This thread updates the announcements for the locally supported channels, 
•/ 

private Thread updateThread - null; 
private static long L_UFDATE - 7500; 

public static IRCUsrApplet owner; 
public static Label label_l; 
public static List direct oryList_l; 
private static int WIDTH - 600; 
private static int HEIGHT - 400; 

/**■■ 

* Instantiates the directory display panel. 
*/ 

public IRCDirectory (IRCUsrApplet main) { 
owner » main; 

GridBagLayout grid - new GridBagLayout < ) ; 
GridBagConstraints cons *» new GridBagConstraints () ; 
setLayout (grid) ; 

cons. fill • GridBagConstraints .NONE; 
cons.weightx - 1-0; 

// label 1 
cons.weightx ■ 1.0; 

cons .gridwidth - GridBagConstraints .REMAINDER; 
label.l - new Label () ; 

label_l . set Text ("Local Channel Directory" ) ; 
grid.setConatraints <label_l, cons) ; 
labels 1 - setForeground (Color . white ) ; 
add(label_l) ; 
validate (); , 

// list 1 - global 

cons .gridwidth - GridBagConstraints .REMAINDER; 
directoryList_l - new List (20, false); 

direct oryList_l.addActionListener (iRCActionHandler .listControl) ; 

grid.setConatraints <directoryList_l, cons) ; 

direct oryList — l .setForeground (Color .yellow. brighter () ) ; 

directoryList_l . setBacfeground (Color . darkGray ) ; 

add(directoryLiat_ 1) ; 

validate ( ) ; 
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// resize 

setSize (WIDTH, HETGHT) ; 
start ( ) ; 

) 

/*• 

* starts the directory update. 
*/ 

public void start <) ( 

updateThread ^ new Thread (this) ; 
updateThread. start <> ; 

} 

/** 

* The run methods for the two threads, 
public void run() { 

!f local directory 

while (Thread. currentThread () == updateThread) { 
try { 

Thread. sleep (L_UPDATE) ; 

Hashtable cdp_lookup - owner . getCache () ; 

if (directoryLiat_l . get ItemCount () > 0) { 
directory List_l . removeAll ( ) ; 

} 

for <int i = 0; i < owner . MAX— CHANNELS; i*+> ( * * 

String Id - St ring . valueOf (i) ; : * 

if (cdp_lookup.containsKey (Id) ) { 

CDPPacket cdp - (CDPPacket) cdp_lookup.get (Id) ; 
directory List_l -add <cdp. id + " • + cdp. name. 

Integer .parse Int (cdp. id) ) ; 

> 

else { 

directoryList_l . add ( Id) ; 

} 

) 

if (cdp_lookup. containsKey (MacconiServer. LOCALSTA) ) { 

CDPPacket cdp - (CDPPacket) cdp_l ookup. get (Marconi Server . LOCALSTA) ; 
di rectory Lis t_l . add (cdp. name) ; 

} 

\ 

catch (Exception e) { 

System, err .print In ("marconi . ire. IRCDirectory .run; •) ; 
e .prints tackTrace ( ) ; 

} 

) 

) 

> 
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/• marconiNet - Internet Radio Network 

* Distributed Radio Antenna Server (RAS> : ( IRC User Applet) 

* $<marconi . irOlRCUsrApplet . java -v2 . 0 (prototype version), 1999/04/20 5 

* <?jdkl.2, -riK. 
*/ 

package marconi.irc; 

import ;ava. applet . *; 

import oava.awt.*; 

iirport java.utii.*; 

irrport 3«va . net . * ; 

//import )ava . rmi . * ; 

//inport java . rmi . server .* ; 

irrpoct mar com . jti 1 . * ; 

irrport mar cor l . jtil . rtsp . IRC; 

in-port marcom . ras . RAS; 

ireport ma rccn i . ras , Marconi Server; 

/•• 

• This applet is used by an IRC user. 

• Gauthor -r;K. 

• ^version SRevxsion: 1.0 5 

• (?aee rearccni . ras .MarconiServer 

* (Jsince prototype vl.O 
*/ 

public class IRCUsrApplet extends Applet 

implements java . io . Ser iali zable, Runnable { t > 



/•• 

* Session Announcement Protocol (SAP) resources. 

* Interfaced via. Channel Directory/Description Protocol (CDP) . 
•/ 

private MulticastSocket cap_receiver - null; 
protected Has ht able capCache - null; 

/•• 

* This thread updates the announcements for the locally supported channels. 
*/ 

private Thread directoryThxead - null; 
private static long L_UPDATE » 10000; 

// raiscellar.eious variables 
private static int width - 0; 
private static int height » 0; 
//protected RAS rasServer - null; 
protected int MAX_CHA1*NELS - 20; 

final static String otjj^nanie - "marconi . ras . IRCUsrApplet"; 
// tools 

iRCDirectory directory - null; 
IRCControls controls • null; 
IRC listener - null; 

/*• 

* Initialize the applet and setup display area. 
*/ 

public void init() { 



try { 



width - Integer .parselnt (getParanieter < "APPLWIDTH* ) ) ; 
height - Integer. parselnt (getParanieter ( "APPLHEIGHT") ) ; 



// lookup RAS (MarconiServer) 
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//URL URl^Ke D get nocumentBase () ; 

/ /System, out . print In (obj_name * ".init: locating server'); 
//rasServer » (RAS) Naming. lookup ( •//" + getParameter ( "RASHost " ) 
// * + getParameter ("RASPorf) 

// + "/marconi . ras .MarconiServer" ) ; 

// init variables 

//MAX_CHANNELS - rasServer . getMaxChanneis (> ; 
capCache - new Hashtable ( ) ; 

> 

catch (Exception e) ( 
// fatal error 

System. err .println (obj_name + ".init: " ) ; 
e.printStackTrace () ; 

> 

// join CAP multicast group 
try ( 

cap.receiver = new Mult icastSocket (MarconiServer .CAP_PORT) ; 
cap.receiver. joinGroup ( I net Address . get ByName t Marconi Serve r . LOCAL. CAP ) ) 

\ 

catch (Exception e) { 

System, out .print In (obj__ name +- ".init:"); 
e .printStackTrace ( ) ; 

> 



// draw display area 
setupOisplay ( ) ; 

// start 

listener » new rRC(); 
directoryThread = new Thread (this) ; 
directoryThread . start () ; 



/** 

* Display the applet. 
*/ 

public void setupDisplay ( ) < 

setBackground (Color .black) ; 



directory = new IRCDirectory (this) ; 
controls • new IRCControls ( ) ; 
GridBagLayout grid - new GridBagLayout ( ) ; 
GridBagConstraints cons - new GridBagConstraints () ; 

// setup grid 

int rowfieightaU - {400, 100} ; 
grid.rowBeights - rowHeights; 
set Layout (grid) ; 

cons, fill — GridBagConstraints .BOTH; 
// add directory lists 

cons.gridwldth - Gr IdBagConstr a inrs .REMAINDER; 
cons, weight x — 1.0; 
cons.gridheight - 1; 

grid.setConstraints (directory, cons) ; 
add (directory) ; 
validate () ; 

// add controls 

cons.gridwidth - GridBagConstraints . REMAINDER; 
cons, weight x — 1.0; 
cons.gridheight - 1; 
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grid. setConstraints (controls, cons); 
add (controls) ; 
validate (); 

resize (width, height) ; 

> 

/*• 

* Free resources when closing applet. 
•/ 

public void destroy () ( 

// release sockets and leave announcement group 
try { 

cap_receiver . leaveGroup ( Inet Address .getByName ( Marconi Server . LOCAL_CAP) ) ; 
cap^receiver .close ( ) ; 

) 

catch (Exception e) { 

e.printStackTrace () ; 

> 

stopChannel ( ) ; 
directoryThread = null; 

//try { 

// rasServer . terminate ( ) ; 
//} 

//catch (RernoteException e) { 
// e . print StackTrace < ) ; 
//} 

*■ 

remove (directory) ? f * 
remove (controls) ; 

} 

/*• 

* Run method. 
*/ 

public void run O i 

// cache update hour 

long hour « System. currentTimeMillis O ; 
/* 

* Global directory thread running. 

V 

while (Thread, cur rentThreadO — directoryThread) ( 
/* 

* Receive COP packets and maintain channel database* 
*/ 

try { 

DatagramPacxet recv_pkt - CDPPacket .compose () ; 
cap_receiver. receive <recv__ pkt ) ; 

CDPPacket cdp - new CDPPacket <recv_pkt) 

System. out .println (ob j_ name + "-run: cdp parsed"); 

// update announcement appropriately 
if < icapCache. contain sKey (cdp. id) ) { 
capCache . put ( cdp . id, cdp) ? 

Sy stem. out. print In (obj_name + ".run: new cdp cached for channel-" 
+ cdp. id) ; 

} 

) 

catch (Exception e) { 
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e . printStackTrace < ) 

) 

// time to refresh cache (daily) 

long current, hour * System. currentTimeMillis ( J ? 

if (current, hour > hour + Times tamp , DAY) ( 

System. out .println (obj_name * ".run: routine -refreshing directory cache , 

ref resh__cache () ; 

hour +- Time st amp . DAY; 

> 

* Interval b/w each loop for receiving local channel directory. 
V 

try ( 

Thread. sleep (L_UPDATE) ; 

> 

catch (interruptedException e) I 
> 

► 

/** 

* Removes old cache entries. 
•/ 

protected void ref resh_cache ( ) ( 

long current. hour = System. currentTimeMillis () ; 

synchronized (capCache) { # * 

Enumeration capList - capCache . elements () ; r * 

while (capList . hasMoreElements () ) { 

CDPPacket cdp « (CDPPacket) capList . nextElement <) ; 
if (currentjiour > cdp. tiraeStamp + CDPPacket ♦ TTL) { 
capCache. remove (cdp. id) ; 

) 

) 



/** 

* Inform server that the specified channel is being listen to. This 

* RMI based triggering is very inefficient and not scalable. So 

* alternate approach based on RTCP should replace this. 
V 

public boolean playChannel <int id) { 
boolean status — false; 

if (capCache. containsKeyl St ring. valueOf Ud) ) ) < 

CDPPacket cdp - (CDPPacket) capCache .get (String .valueOf (id) ) ; 
try { 

// kill previous thread if running 

listener . stop ( ) ; 

/* 

* The below statement is commented out because the listener 

* is now capable of sending RTCP signals for triggering. 
* 

status - ra3 Server .playChannel (id) ; 
*/ 

status - true; // replace above 
listener, start (cdp.MADDR, cdp.MPORT) ; 

> 

catch (Exception e) i 

e . print StackTrace ( ) ; 
return false; 
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} 

return status; 



} 

else < 



return false; 



/** 

* Stops listening to whatever is playing. 
*/ 

public void stopChannel { ) { 
listener.stopO ; 



* Returns the current state of the local channel announcement cache. 
*/ 

protected synchronized Hashtable getCache <) { 
return capCache; 



• Return applet information. 
*/ 

public String getAppletlnf o ( ) i 
return "IRC listener tool"; 

} 
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'* marconiNet - internet Radio Network 
- * Distributed Radio Antenna Server (RAS) : tAD GUI Controls 1 
* 

* $<marconi.ras.>ADControls. java -v2 . 0 (prototype version), 1999/05/16 5 
• * G;jdkl.2, ~riK. 

* V 

package marconi.ras; 

.mport java.awt.*; 

tmport java. awt . event . *; 

Import java.io.*; 

Lmport marconi . util . Vector2; 

/ * # 1 

* This panel contains user interfaces for the ad insertion. 
*/ 

sublic class ADControls extends Panel i 
public static RASMgrApplet owner; 
public static Choice ids; 
public static TextField entry_l; 

public static Button button_2, button_3, button. 4; 
public static List directoryList_l; 
private static int WIDTH = 600; 
private static int HEIGHT *» 200; 
private static Vector2 ads - new Vector2(); 

/** 

* Instantiates the control panel. 
*/ 

public ADControls (RASMgrApplet main) { 
owner — main; 

GridBagLayout grid « new GridBagLayout () ; 
GridBagConstraints cons « new GridBagConstraints () ; 
setLayout (grid) ; 

cons. fill » GridBagConstraints . BOTH; 
cons.weightx » 0.0; 

// channel id 
ids « new Choice ( ) ; 
update IDs () ; 

grid.setConstraints <ids r cons) ; 
ids . setForeground (Color. black) ; 

/ / ids . setForeground (Color . yel low . darker < ) ) ; 

ids . setBackground (Color . lightGray ) ; 
// ids .set Background (Color, black ) ; 

add (ids) ; 
validate () ; 

// commercial file> input 
entry_l - new TextField (20 ) ; 
grid.setConstrainta<entry_l, cons) ; 
entry_l .setForeground (Color. black) ; 

// entry_ 1. setForeground (Color, yellow, darker () ) ; 

entry. 1. setBackground (Color, gray, brighter () ) ; 

// entry_l . setBackground (Color . blue, darker () .darker ()) ; 

add(entry_l> ; 
validate O; 

// add commercial 

cons .gridwidth - GridBagConstraints . REMAINDER; 
button_2 = new ButtonC Add Commercial ")# 
button_2 . setActionCommand(*Add Commercial") ; 
button_2 . addActionListener (RASActionHandler .buttonControl) ; 
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button_2 . setBackground (Color . lightGray) ; 

// butt on_2. setBackground (Color . black) ; 

button_2 . aetForeground (Color . black) ; 

// button_2. setForeground (Color . red) ; 

grid. setConstraints (button_2, cons); 

add (button_2) ; 

validate (); 

// list 

// cons.weightx = 1.0; 

cons .gridwidth - GridBagConstraints . REMAINDER; 
directoryList_l = new List (5, false); 
grid. setConstraints (directoryList_l, cons) ; 
directoryList_l . setForeground (Color .black) ; 

// directoryList_ 1 . setForeground (Color. yellow. brighter () ) ; 

directory List_l . setBackground (Color . white) ; 

// directoryList_l . setBackground (Color .darkGray) ; 

add (directoryList_l) ; 

validate (); 

// submit commercial list 

cons .gridwidth » GridBagConstraints . RELATIVE; 

button_3 - new Button (" Submit List *); 

button_3 . set Act ionComraand ( "Submit Commercials"); 

button^ 3 „ addActionListener (RASActionHandler .buttonControl) ; 

button.. 3 . setBackground (Color . 1 ightGray ) ; 

// butt on_3 .setBackground (Color .black) ; 

but ton — 3. setForeground (Color .black) ; 

// button_3 . setForeground (Color . red) ; #' 

grid. setConstraints (button_3, cons); # i 

add(button_3) ; 
validate ( ) ; 

/ / remove commercial 

cons, gridwidth - GridBagConstraints .REMAINDER; 

button_ 4 =■ new Button (* Remove All *) ; 

butt on. 4 . setActionCommand ( "Remove Commercials • ) ; 

button_4 .addActionListener (RASActionHandler .buttonControl) ; 

button_4 . setBackground (Color. lightGray) ; 

/ / button_4 . setBackground (Color . black) ; 

button_4 • setForeground (Color .black) ; 

// button_4 . setForeground (Color . red) ; 

grid. setConstraints (button_4, cons); 

add(button_4) ; 

validate ( ) ; 

// resize 

setSize (WIDTH/ HEIGHT); 

} 

/" 

* Add additional entry. 

protected static void processAddO ( 

if (entry — l.getTextO .length () > 0) { 
try < 

String entry • Integer . parse Int (ids .get Select edltemO ) + " " ♦ entry_l.get: 

* t O.- 
directoryList^l. add (entry) ; 
ads . adcUSlement (entry) ; 

} 

catch (NumberFormatException e) { 

owner. showMessage ("Please select a channel! 9 , true); 

) 
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) 

// clear input fields 
entry.l.aetText <"") ; 

> 

* Remove all entries. 
•/ 

protected static void proceaaRemove () ( 
if uds.sixeO > 0) < 

directoryList.l . removeAll () ; 
ads . cenoveAl lElements ( ) ; 

i 

) 

/** 

* Submit the cc««iciil list to the server. 
*/ 

protected stat;c void process Submit ( > < 
try { 

if (ad*. »**•(» > 3 44 owner . r as Server . submitCommercialList (ads. toStr ingArray ()> ) 

{ 

cvn«i . i^.»«Mf »»ao,e t" Commercial list submitted...", false); 
ent ry_l . 9et7e«t <"* • ; 
else < 

ovnfc . •nowMeeaa^e < •Commercial list could not be submitted*", true); , » 
> ■ . t 

) 

catch (Exception el t 

owner. shcvMesse^e (*Coa«*«rcial list could not be submitted!", true); 

) . ' 
/** 

* Updates available channel ids. 
*/ 

protected static void updateIDs() { 

ids . removeAl 1 ( ) ; 

for (int i - 0; i < owrer. channel IDs . length; i ■*-■*•) ( 
if (owner .channel ID • (i} ) ( 

ids .add (jtring .valueOf (i) ) ; 

) 

) 

if <ids.getXte«Co<int <) — 0) { 
ids . add ("EMPTY* I ; 

> 

} 
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/* marconiNet - Internet Radio Network 

* Distributed Radio Antenna Server (RAS) : [Channel Class] 
* 

* $<marconi . ras . >Channel . java -v2 . 0 (prototype version) , 1999/01/06 $ 

* ejdkl.2, -riK. 
*/ 

package marconi . ras; 

import java.io.*; 

import java.net.*; 

import java.util.*; 

import java . rmi - * ; 

import marconi - ut il- *; 

import marconi . util . rtsp -* ; 

import marconi . rsc. RSC; 

import java . security . Security; 

import j a vax . crypto. * ; 

import javax . crypto. spec . *; 

import au . net . aba. crypto .provider . ABAProvider; 



* The <code>Channel</code> class creates two threads in which it can start 

* the neccessary operations for maintaining the channel. First, it creates 

* a thread that listens and monitors the RTCP signals from tRCs. when this 

* thread detects that there is at least one IRC that wants to listen to this 

* channel, it creates the second thread which begins performing the redirection 

* process (receive content front global address , decrypt, write content to 

* local address) . The <i>rtcp thread</i> continues the monitoring so that 

* if it detects that no one is listening to the channel anymore it terminates 

* the <i>redirection thread</i>. This helps reduce the bandwidth being wasted. 

* Additionally, <code>Channel</code> will store the details of its content 

* provider (radio station) and the broadcast/multicast medium. 

* <p> 
* 

* Gauthor -riK. 

* (? vers ion $Revision: 1.0 5 

* Gsee marconi . ras .MarconiServer 

* Gsee marconi . ras .StationProf ile 

* Gsince prototype vl.O 
V 

public class Channel implements Runnable { 

final static String obj_name - "marconi . ras .Channel' ; 



* The assigned channel number. 
*/ 

protected int chanID; 
/** 

* The radio station. 
*/ 

private RSC station - null? 
/** 

* The radio station's hostname, 
private String host *» null; 

/** 

* The radio station name. 
V 

public String name * null; 



/** 
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* The main category of this channel's content { music I news | sports | ... \. 
V 

public String category - null; 
/** 

* The content description. 
*/ 

public String description ° null; 



* The origin of the content. 
*/ 

public String origin » null; 
/** 

* The language used in the content. 
V 

public String language - null; 
/** 

* The radio station's url (not in use by the current protocol). 
V 

public URL url - null; 
/•* 

* The station's glocal multicast address, 
protected r net Address g_rnaddr; 

* The station's local multicast address. 
*/ 

protected I net Address l_maddr; 
/* 

* The encryption resources. These private declaration allows for later 

* extension where the hard-coded values such as the SEK algorithm and key 

* length can be obtained from announcement. In such cases various encryption 

* methods can be supported and allows the encrypting party (content sender) to 

* decide on which algorithm to use. 
*/ 

private byteCl SEK => null; // session encryption key 

int seK_id - -If // RSC registration id 

byte (J publicKey - null; // RSA public key 

byte [J privateKey - null; // RSA private key 

private final static String SECRET^AIG ■» *RC4"; // encryption algorithm 
private final static int SEKLEN - 8; // encryption key length 

/** 

* Channel database initialized (install JCE and thread counter) . 
*/ 

private static boolean DB_INIT IAI*I ZED - false; 
/*♦ 

* Daily program schdule. 
*/ 

private Has ht able programSchedule - null; 
/** 

* Daily commercial schedule. 
V 

private Haahtable commercial Schedule - null; 



/** 
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* The radio antenna server can activate the channel broadcasting by 

* starting this <code>channelThread</code> . 
*/ 

private Thread channelThread ■» null; 
/**' 

* The channel broadcasting does not actually begin unless this RTCP listener 

* thread defects that there is at least one listener present at the time. 
*/ 

private Thread rtcpThread » null; 
/*• 

* This variable incicates the state of the thread (active or suspended) . 
•/ 

private boolean threadSuspended « false; 
/** 

* Manages :h« number of running threads (channels) . 
V 

protected s'.auc ThreadCcuntManager threadCounter - null; 
/** 

* The RTCP lir.trtf . 
V 

private RTCPLi«t#ner rtcpL-stener - null; 
private RTC?Soc*et rtcpfteqistry ■ null; 

/* 

* Multicast resources. « 

byte recv_buf[|; // receiver buffer 

byte sendL_buf 1 1 ; // receiver buffer 

DatagramPacket recv^pacfc; // receiver packet 

DatagramPacket sendUpack; // receiver packet 

private Multicast 3©c*«t cccvjiaock; // multicast socket for receiving 

private Multicastlocaet sendLjuock; // multicast socket for sending 

private boolean soCKXT_IH_USe - false; // prevents abrupt socket kill 

/** 

* Creates a new thread and starts the <code>Chanxiel</code> operation 

* which consists of broadcasting (multicasting) the channel contents 

* to its local client* and storing the station profile. 
* 

* Gparara chan_id the channel number. 

* G par am maddr the local multicast address. 
*/ 

public Channel (int chan_id, I net Address maddr) { 

// install jce provider 
if ( !DB_INITXALXIED) ( 

threadCounter • new Th readCount Manager () ; 

DB_INITIALIZCD - Security . addProvider (new ABAProvider O ) > -1; 

> 

// initialize channel 
chan ID - chan_id; 

prograx&Schedule - new HashtableO; 
conunercialSchedule - new HashtableO; 
g_raaddr — null; 
l_maddr — maddr; 

// initialize rtcp listener 

rtcpRegistry * new RTCP Socket (MaddrDispenaer . rtcp_juap (maddr) , 

MarconiServer . irc_PORT+1, true) ; 
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rtcpLiatener - new RTCPListener ( rtcpRegiat ry, 
rtcpListener . start ( ) ? 
rtcpThread ™ new Thread (this) ; 
rtcpThread. start <) ; 

> 

/»• 

* This <code>run</code> method implements the channel's broadcast 

* operation. 
•/ 

public void run () { 
/ • 

• Channel thread running. 

• / 

while (Thread. currentThread ( ) -« channelThread) ( 

// receive audio packet 
SOCKET_IN_USE = true; 
try ( 

// init receiving packet 

recv_buf - new byte (Marconi Server . MAX_PAYLOADLEN 

+ MarconiServer .MAX_RTPHDRLEN] ; 
recvjsack - new DatagramPacket ( recv_buf , recvjbuf . length) ; 
recv_msock . receive <recv__pack) ; 

//System . out .print In ( "received RTP from " + recv__pack . get Address < ) + ":" t 

+ cv_pack .getPort () ) ; 

) * * 

catch {Exception e) i , » 

Sy stem. out .print In <obj_name + ".run: channel-* + chanID) ; 

e .printStackTrace () ; 

I 

SOCKET_in_use - false; 

// Decrypt & send local 
int n - recv_ pack . getLength ( ) ; 
if (n > 0 46 SEK !- null) { 
try { 

//Cipher cipher - Cipher . get Instance ( SECR£T_ALG ) ; 

//cipher . init (Cipher . DECRYPT.. MODE, new Secret Key Spec (SEK, SECRET^ALG) ) 

//byte[] send_buf - cipher .doFinal <recv_pack . getData {)) ; 

byte(] send_buf - recv_pack .getData () ; 

send_pack - new DatagramPacket (sencLJbuf, n, l_maddr , 

MarconiServer . IRC_PORT) ; 
3end_m30ck.send(send_pack, (byte) MarconiServer.LOCAl._TTL) ; 
//System. out .println ("sent to • +• send_pack, get Address <) +• ":" + sencL_P« 

+ k.getPort () ) ; 

} 

catch (Exception e) < 

Sy stem. out. print In <obj_name ♦ ".run: ") ; 
e . printStackTrace < ) ; 

} 

} 

/* Un comment below to use variable sleep feature, (and comment above) . 

* Sleep, (accordingly wrt # of running channels) 

•/ 

try { 

Thread . sleep ( threadCount er . getSleepTime ( ) ) ; 

synchronized (this) { 

while ( threads uspended £& channelThread »- null ) < 
wait Of 
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) 

) 

catch (InterruptedException e) ( 
) 

/•*/ 

// let other channels (threads) run (time-slicing) 
//Thread. yieldO ; 

) 

/• 

* RTCP listener thread running. 
*/ 

while (Thread. current Thread ( ) rtcpThread) ( 

/ /System. out -print In (ob j_name + ".run: channel-" + chanID + * num ircs a " + rtcpRe 
gistry .getNumMembers () ) ; 

// determine whether or not to start the channel thread 
if (!isOnline() 66 rtcpRegistry .getNumMembers < ) > 0) { 
try ( 

start () ; 

System, out .print In (obj_ name + ".run: channel-* ■♦■ chanID 
+ " started"); 

) 

catch (Exception e) { 

System. err .println <obj_name + 

".run: cannot start channel-" + chanID) ; 

) 

// determine whether or not to stop the channel thread 
if (isOnlineO &6 rtcpRegistry .getNumMembers () — 0) ( 
stopO; 

System. out .print In <obj_naroe + ".run: channel-* + chanID 
+ ■ stopped**); 

/* Un comment below to use variable sleep feature, (and comment above) . 

* Sleep* (accordingly wrt # of running channels) 

*/ 

try { 

Thread. sleep (threadCounter. gets leepTime () ) ; 

synchronized (this) < 

while ( threads uspended 46 channelThread !- null ) { 
wait(); 

) 

> 

} 

catch (InterruptedException e) ( 
) 

/**/ 

// let other channels (threads) run (time-slicing) 
/ /Thread . yield () ; 

) 

} 

/** 

* Starts the broadcast thread for this channel. The channel will begin 

* to listen on its content provider's data stream and do its protocol 

* process (strip-off header, check for special packet, decrypt, etc.) 

* and broadcast (multicast) the remaining audio data to all clients tuned 

* to this channel. 
* 

* <> except ion TooManyChannelThreadsException if too many 
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* <code>ChannelThread</code>s are running (broadcasting) . 

•/ 

public synchronized void start () throws TooManyChanneLThreadsException { 

if ( lisOnline (> ) { 

if (gL_maddr !- null &£ threadCounter . addThread ( ) ) { 
System. out .println (ob j_name 

+ ".start: initializing channel-* 
+ chanlb) ; 

// create sockets & join group 
try \ 

send_msock - new Multicast Socket () ; 

recv_jnsock - new MulticastSocket (MarconiServer . RSC_PORT) ; 
recv_msock . joinGroup (g_maddr ) ; 

} 

catch (lOException e) { 

System. err .println (ob j_name + ".start:"); 
e .printStackTrace ( ) ; 

) 



// start channel announcement thread 
channelThread - new Thread(this) ; 
channelThread . start ( ) ; 

> 

else { 

throw new TooManyChannelThreadsException 

(obj_ name + ".start: too many threads running*); 

> 

J 

else { 

throw new I HegalThreadStateExcept ion 
(obj_narae 

+ ".start: broadcast thread already running for channel-" 
+ chanID) ; 

) 

> 



/** 

* Stops the broadcast thread for the channel. The channel itself is not 

* to be destroyed. 
*/ 

public synchronized void stopO { 

if (isOnlineO) < 

if (threadCounter .reraoveThread () ) \ 



// free sockets 6 threads 
try | 

channelThread - null; 
while <SOCKET_IN_USE) < 
Thread. sleep (3) ; 

} 

recv_ msock . leaveGroup <g_maddr ) ; 
recv_jnaock • close < ) ; 
sendLjnsock. close <) ; 

\ 

catch (Exception e) i 

System, err .println (obj_narae +■ ".stop:"); 
e. print StackTrace () ; 

> 

finally { 

notify () ; 
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) 

else 4 

// do nothing 

) 

> 

else { 

throw new IllegalThreadStateExcept ion 
(ob j_name 

+ ".stop: broadcast thread not running for channel-* 
+ chanID) ; 

\ 

/** 

* Stop all threads and destroy this object. 
•/ 

public synchronized void destroy () { 
stop O ; 

rtcpThread - null; 
rtcpListener . stop ( ) ; 
rtcpRegistry .close ( ) ; 

) 

/** 

* Temporarily suspends the running broadcast thread. 
*/ 

public synchronized void suspend O < 

if (isOnlineO) < # 
threadSuspended - true; * , 

notify <) ; f * 

> 

else { 

throw new IllegalThreadStateExcept ion 
<obj_name 

♦ ".suspend: broadcast thread not running for channel-* 
4- chanID) ; 

) 

\ 

/** 

* Resumes the broadcast operation. 
*/ 

public synchronized void resume () { 

if (isOnlineO) { 

threadSuspended - false; 
notify () ; 

} 

else { 

throw new IllegalThreadStateExcept ion 
(obj_ name 

+ • : broadcast thread not running for channel-" 
+ chanID) ; 

> 

/** 

* Tests to see if thread is running (i.e. channel is broadcaating) . 
V 

protected synchronized boolean isOnlineO { 

return (channelThread !- null) ? true : false; 

\ 
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/** ^ 

* Initializes broadcasting process. Registers (make payment) with the radio 

* station to obtain the SEK. Set key pair (public/private) . 
* 

* Gparam pubKey public key of RAS, as given by <code>MarconiServer</code> . 

* Q pa ram privKey private key of RAS. 
*/ 

protected synchronized boolean init(byte[] pubKey, byte[] privKey) { 
this .publicKey - pubKey; 
this .privateKey - privKey; 
try { 

System. out .print In (obj_name + ".init: contacting RSC at " 

+ host + 9 . . . " ) ; 
station =* (RSC) Naming . lookup (•//" + this. host 

+ " : ■ + Marconi Server. RMI_P0RT 
+> w /marconi . rsc . station") ; 
sek__id 01 station . enroll (publicKey ) ; 
System, out . print In (obj_name 

+ *.init: public key submitted (sekid-* + sek — id + ")"). 

> 

catch (Exception e) ( 
return false; 

> 

if (sek_id > -1) ( 
return true; 

) 

else ( 

return false; 

I 

> 

/** 

* Adds individual commercial into the channel database . 
* 

* dparam ad_id advertisement id or commercial filename. 
*/ 

protected synchronized void addCoramercial (String adLjLd) { 

// set date using the time at GMT at 0 hour (midnight) 
Date date ■ new Date (Times tamp .get_midnight () ) ; 

if ( icommercialSchedule.containsKey (date) ) { 
vector2 ad^list - new vector2(); 
commercial Schedule .put (date, aO_ list); 

> 

Vector2 ad_list - (Vector2) commer cial Schedule .get (date) ; 
a delist . addEleraent (ad_id) ; 

} 

/** 

* Removes the list of commercials in the database. 
*/ 

protected synchronized void removeCommercials <) ( 

// set date using the time at GMT at 0 hour (midnight) 
Date date - new Date (Timestarap.get_jnidnight () ) ; 

if (commercialSchedule.containsKey (date) ) ( 

Vector2 ac\_list - (Vector2) commerc ial Schedule. get (date) ; 
a delist . removeAll Elements () ; 

> 

> 
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* Generates a commercial list file from the channel dat 

* of a list of filenames to be read-in by the advertisement insertion module. Each 

* file in the list should contain the actual audio data for the commercial playing 

* and its name is added to the database via. <code>addCommercial ( ) </code> method. 

* The commercial-list file takes the global multicast address of this station in 

* numerical format appended by ".lst". 
•/ 

protected synchronized void genCommercialFile () { 
Date date *■ new Date (Time 3 tamp, get_midnight ()) ; 

if (commercialSchedule.containsKey (date) > { 
try { 

File file = new File (g_maddr . get HostAddress ( ) + ".1st"); 

PrintWriter fout * new PrintWriter (new Buff eredwriter (new FileWriter ( f ile) ) ) 

Vector2 ad_list = (Vector2) commercialSchedule . get (date) ; 
String {) ad_arr - ad_list . toStringArray ( ) ; 
if (ad_arr !- null) { 

for (int i = 0? i < ad_arr . length; i++) { 

fout .println< <ad_arr [i] !- null) ? ad_arr[i] : "*); 

} 

> 

System, out .println (obj_name + ".genCommercialFile: file updated 
+ new Date () ) ; 

fout .close () ; 

) 

catch (TOException e) { 
> 



/** 

* Returns channel statistics. 
* 

* (Jreturn channel accounting information packaged in <code>ChannelStatistics</code> 

* class. 

protected synchronized ChannelStatistics audit () { 

return new ChannelStatistics (String. valueOf (chanID) , rtcpRegistry .getNumMembers () ) ; 

> 

* Reads from a CDP packet and extracts channel information. 
* 

* Gparam cdp the channel description packet to be parsed. 
•/ 

protected synchronized void readme dp (CDPPacket cdp) { 
if (cdp. name !- null) ( 
this. name • cdp. name; 

} 

if (cdp. category !- null) { 

this. category - cdp. category; 

> 

if (cdp. description !- null) ( 

this. description « cdp -description; 

> 

if (cdp. language !- null) ( 

this. language - cdp. language; 

} 

if (cdp. origin !- null) { 

this. origin - cdp. origin; 

} 

if (cdp.MADDR I- null) ( 
try ( 
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this . g_maddr • metAddress .getByName (cdp . MADDR) ; 

> 

catch (Exception e) { 
} 

} 

if (cdp. id !« null] ( 
this. host - cdp. id; 

} 

if (cdp.SEKLIST != null) { 

if (sek_id >=» 0 &£ sek_id < cdp . SEKLIST. length) { 
if (cdp. SEKLIST (sek_id) !=» null) { 
SEK = new byte (SEKLEN) ; 

byte() terop_byte » Base64 .decode (cdp . SEKLIST [sek_id] . get Bytes ( ) ) ; 
System. arraycopy (temp_byte, 0, SEK, 0, 

Math .min (temp_byte . length, SEKLEN) ) ; 

> 

) 

if (cdp. date != -1 && cdp. schedule ! - null) ( 

// set date using the time at GMT at 0 hour (midnight) 
Date date = new Date (Time stamp . get .midnight (cdp. date) ) ; 

// store schedule 

programSchedule. put (date, cdp . schedule) ; 
/* 

* The commercial database design is not utilized in this version. 

* Instead, refer to genCommercialFile ( ) and its related methods for ,* 

* supporting LA IP (local advertisement insertion protocol) . : i 
# 

commercial Schedule .put (date, new CommercialSchedule () ) ; 
*/ 

\ 

) 

/** 

* Writes current channel information to a CDP packet . The scheduling 

* information is only done for the current date. Thus the server is not 

* supported to post announcements for future dates. 
* 

* Qreturn a fully initialized CDP packet. 
*/ 

protected synchronized CDPPacket write_cdp() ( 
CDP Packet cdp - new CDPPacket (); 

// get today's date at 0 hour. 

Date today ™ new Date (Times tamp, get_midnight ()) ; 

// copy channel info 

cdp . name " this • name ; 

cdp. category - this .category; 

cdp. id - String. valueOf (this. chanlD) ; \ 

cdp. description - this .description; 

cdp. origin - this. origin; 

cdp . language - this . language; 

cdp . MADDR - this.l_ maddr.getHostAddress ( ) ; 

cdp.MPORT - MarconiServer . IRC_PORT; 

cdp.MTTL - MarconiServer .LOCAL_TTL; 

// copy schedule info 

cdp. date - today .get Time () ; 

String sched - (String) t his. programSchedule. get (today) ; 
cdp. schedule - (sched — null) ? : sched; 
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return cdp; 



* The <code>ThreadCountManager</code> class implements the operations done 

* on the number of running threads. It defines the maximum number of threads 

* (i.e. channels) . It also calculates the announcement interval time by taking 

* number of channels into account. 

* <p> 
* 

* Gauthor ~riK. 

* Gversion SRevision: 1.0 $ 

* Gsince prototype 1-0 
*/ 

class ThreadCountManager < 
int threadCount « 0; 

public final static int MAX_THREAD COUNT - Marconi Server .MAX_CRANNELS; 
final static int MAX_SLEEPTIME - 200; 
final static int MIN_SLEEPTIME - 20; 

/** 

* Increments the thread counter. 
*/ 

protected boolean addThreadO { 

if (threadCount < MAX_THREADCOUNT) { 
threadCount++; 
return true; 

} 

return false; 

J 

/** 

* Decrements the thread counter. 
*/ 

protected boolean removeThread () { 
if (threadCount > 0) < 
threadCount — ; 
return true; 

) 

return false; 

} 

/** 

* Tells whether there are no threads. 
*/ 

protected boolean isEmptyO { 

return (threadCount — 0) ? true : false; 

} 

/** 

* Returns the number of running threads. 
*/ 

protected int getCountO { 
return threadCount? 

) 

/** 

* Returns each thread's appropriate sleep time in number of milliseconds. 

* The more threads running, the less sleep time for each thread. 
*/ 
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protected int getSleepTime ( ) < 

return Math .max (MAX_SLEEPTIME - threadCount * 10, MIN_SLEEPTIME) ; 

> 

> 
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/* narconiNet - Internet Radio Network 

* Distributed Radio Antenna Server {RAS) : 
* 

* $<marconi . ras . >ChannelMonitorApplet . java 

* Gjdkl.2, -nK. 
*/ 

package marconi.ras; 



14:24:02 1999 

[Channel Monitoring Applet] 

-v2 . 0 (prototype version), 1999/05/22 $ 



import java. applet .Applet ; 

import java.awt . *; 

import java .util . * ; 

import java.net.*; 

import java.rmi.*; 

import java. rmi - server .* ; 



* The ChannelMonitorApplet exports a remote object, and periodically contacts 

* to obtain channel accounting information and plots it in graph format. 
*/ 

public class ChannelMonitorApplet extends Applet 
implements Runnable ( 
final static int INCR - 10; 
final static int GRIDLEFT = 150; 
private static int WIDTH - 600; 
private static int HEIGHT - 350; 

private static String title =» 

final static String obj_nanie - "mar coni . ras . ChannelMonitorApplet ; 
Thread updateThread - null; 

private Hashtable channelTable - new HashtableO; 
private RAS rasServer = null; 



/** 

* Updates channel status. 
*/ 

public void update ( ) { 

ChannelStatistics {] channels - null; 
try { 

channels - rasServer. getStatistics () ; 

System, out .println (ob j_name + ".update: * + new Dated); 

} 

catch (RerooteException e) ( 

for (int i ■ 0; i < channels. length; i++) ( 
if (channels[i) !- null) < 

ChannelData data - (ChannelData) channelTable. get (channels (x] .chan_id) , 

if (data !- null) { 

data .update (channels [i] ) ; 

) 

) 

) 

repaint < ) ; 

} 



/** 

* Periodically update. 
*/ 

public void run() < 

while (Thread. currentThread () — updateThread) ( 

try { 

Thread. sleep(10000) ; 

> 

catch ( inter ruptedExcept ion e) ( 
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> 

update () ; 

> 

) 

public void start <) < 

updateThread - new Thread (this) ; 
updateThread. start () ; 

} 

public void stopO { 

updateThread « null; 

) 

/** 

* Initializes the applet. 
V 

public void initO { 
try < 

// lookup RAS server 

URL URlbase = getDocurnentBaseO ; 

System, out . println <obj_name ♦ Vinit: looking up RAS*); 

rasServer • (RAS) Naming. lookup ("// " + URUbase . get Host ( ) + ■ : • 

+ getParameter ( "RASPort •) 
•*- Vmarconi . ras .MarconiServer" ) ; 

) 

catch (Exception e) { 

e . print St ackTrace ( ) ; 

t * 

ChannelStatistics [ ] channels - null; 
try < 

channels « rasServer .getStatist ics () ; 

System, out .println <obj__name + ".init: " + new DateO); 

} 

catch (RemoteException e) { 
e . printStackTrace ( ) ; 

} 

for (int i - 0; i < channels . length; { 

if (channels (i] !- null ! channelTable . containsKey (channels (i) .chan^id) ) < 

channelTable .put (channels [i] .chan_id, new ChannelData (channels (i J .chan_id) ) ; 

) 

> 

setBackground (Color. white) ; 
setLayout (null) ; 

// draw checkboxes 
int i - Of 

Enumeration enura - channelTable .elements () ; 
while (enum.hasMoreElements () ) ( 

ChannelData data - (ChannelData) enum . next Element () ; 

SmartCheckbox cb - new SmartCheckbox (data, this); 

data. cb - cb; 

add(cb); 

validate (); 

cb. set State (data .displayed) ; 
cb.setBounds (10, i++*30+25, 60, 18); 

> 



* Called when applet is destroyed. 
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public void destroy <) { 
> 

/** 

* Paints the panel. 
*/ 

public void paint (Graphics g) { 

// draw title 
g.setColor(Color -black) ; 

g.drawSt ring ( "Channels monitored:"/ 10, 10); 

// draw grid lines 

g. set Color (Color .darkGray) ; 

for (int i - GRIDLEFT; i < WIDTH; i +- 50) { 
q.cr««#lineU* 0, i, HEIGHT - 50); 

) 

for (irt t - 0; l < HEIGHT; i 50) { 

g.cra-Line (GRIDL£FT # i, WIDTH - 50, i) ; 

} 

g.setCcloc fColor .tlack) ; 

for (ir.t i»0; k < HCIGHT; i +- 50) { 

int a • i / * • 

if i* >• 10C) « - 24; 

else if t« i5) a - 

else k • 10; 

g.drawStCAivj tit rirg . valueOf (i/2) , GRIDLEFT - x, HEIGHT - 50 - i>; 

) 

* * 

// draw channels , * 

Enumeration tnua - channel Table . elements O ; 
while (enun.h49Morttl«««nts()) ( 

ChannelData data - (ChannelData) enura. next Element () ; 

int sue; 

ChannelStatist ics [ | updates; 
synchronittd < data . updates) { 

size - data. updates. size <> ; 

updates - new ChannelStat istics [size] ; 

data, updates, copy Into (updates) ; 

} 

g . setColor (data. color ) ; 
if (data. displayed) < 

// draw tx>« around checkbox if mouse is over it 
if (data.cto ' • null 44 data . cb.haveMouse ( ) ) ( 
Point p - dat a. cb. get Location!) ; 
Dimension d • data. cb. get Size () ; 

g.drawRect <p.x-l, p.y-1. d.width+4, d.height+4); 
g.drawfleet (p.x-2, p.y-2, d.width+4, d.height+4); 

// point to graph for stock 
if (stxe > 0) < 

g . d r awL i ne ( p . x+d . width+2 , p . y +1 0 , GRIDLEFT , 

scale (updates [0] . listenerCount) ) ; 
if (updates (size - 11 !- null) I 

g.drawString (String. valueOf (updates Isize - 1] . listenerCount) , 
GRIDLEFT+size * INCR, 

scale {updates [size-1] . listenerCount) ) ; 

) 

} 

\ 

// draw graph of updates for this stock 
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int x - GRIDLEFT; 

for (int i - 0? i < size; i++) { 
if (updates [i) !=■ null) ( 

g. fillOval <x-l, scale (updates ( i 1 .listenerCount)-!, 4, 4) ; 
if <(i < size - 1) && updates [i + 1] !• null) ( 

g .drawLine (x, scale (updates [ i] .listenerCount), 

x + INCR, scale (updates (i + 1 ]. listenerCount )> ; 

\ 

> 

x +- INCR; 



/• 

• Used to scale y-values . 
•/ 

int scale (float y) i 

return HEIGHT - (int) (y*3+.5) - 50; 
//return HEIGHT - (int) <y*2*.5) - 50; 

/• 

* Make sure that mouseHere is set properly. 
V 

void seiMouseHere (boolean display) { 

Exoneration enum - channelTable . elements () ; 

wniie (enum. hasMoreElements ( ) ) { ** 
ChannelData data - (ChannelData) enum. nextElement ( ) ; ♦ : 

data .cb. mouseHere - display; 

) 

> 

) 

/*• 

* ChannelData contains stock updates and display information. 
•/ 

class ChannelData ( 



// channel 
public String id; 

private static int channelCount • 0; 

// update history 

public Vector updates; 

private static int updateCount; 

final static inc MAX^UP DATE S - 34; 

// display 

public boolean displayed; 
public Smart Checkbox cb; 
public Color color; 

private Color(] colorTable - {Color .black. Color. gray. Color. cyan. 

Color. pink. Color .magenta, Color .orange, 
Color .blue. brighter () , Color. green, 
Color. red. br ighter () , Color. gray); 



* Constructor. 
•/ 

public ChannelData (String id) { 
this. id - id; 

this. color - colorTable [channelCount++ % colorTable . length] ; 
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this, updates » new Vector <MAX_ UPDATES) ; 
displayed « true; 

> 

/* 

* Updates channel status. 
*/ 

void update (ChannelStatistics channel) t 
synchronized (updates) { 

if (updates . size <) « MAX_UP DATES) { 
updates . re move Element At (0) ; 

> 

if (updates . size ( ) < updateCount - 1) ( 

for (int i = updates . size () ; i < updateCount - 1; { 
updates . addElement (channel) ; 

> 

) 

updates . addElement (channel) ; 
updateCount - updates . 3ize O ; 

> 

/** 

* Resets counters. 
*/ 

public static void reset () { 
updateCount « 0 ; 
channelCount = 0; 

} t* 
/* 

* A smart checkbox that records whether the mouse is over the checkbox. 
*/ 

class SmartCheckbox extends Canvas i 
ChannelData data; 
boolean state ° true; 
ChannelMonitorApplet panel; 
boolean mouseHere = false; 

public boolean haveMouse() { 
return mouseHere; 

\ 

/*• 

* Constructor. 
*/ . 

public SmartCheckbox (ChannelData data, ChannelMonitorApplet p) ( 
this. data - data; 
panel - p; 

} 

public boolean mouseEnter (Event evt, int x, int y) { 
if (state) ( 

//panel . setMouseHere (false) ; 
mouseHere «■ true; 
panel . repaint ( ) ; 

) 

return false; 

> 

public boolean mouseExit (Event evt, int x, int y) { 
if (state) { 

mouseHere — false; 
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panel. repaint {); 

I 

return false; 

) 

public boolean mouseDown (Event evt, int x, int y) ( 
if (state) 

state - false? 

else 

state - true; 
mouseHere « state; 
data . displayed =» state; 
repaint < ) ; 
panel . repaint < ) ; 
return true; 

I 

public void paint (Graphics g) ( 
g. set Color (Color . white) ; 
g.drawLine (4,4,14,4); 
g.drawLine (4,4,4, 14) ; 
g . setColor (Color .gray) ; 
g. drawLine (5,14,14,14); 
g.drawLine (14, 5,14,14); 
g. setColor (data. color) ; 
g.fillRect (5,5,8,8); 
g. setColor (data. color) ; 
g. drawstring ("Ch-* + data. id, 17, 15); 

g. setColor (Color. white) ; , 
if (state) < , 
g.fillRect (7, 1, 4, 4) ; 

\ 

) 

public void setstate (boolean s) { 
state =» s; 
repaint ( ) ; 

) 

) 
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/* marconiNet - Internet Radio Network 

* Distributed Radio Antenna Server (RAS) : [Channel Accounting Data] 
* 

* $<marconi .ras . >ChannelStatist ics - java -v2 . 0 {prototype version) , 1999/05/22 S 

* (3jdJcl.2, -riK. 
*/ 

package roarconi . ras; 
/** 

* This class encapsulates the channel accounting information, such as the number 

* of current listeners. It can be extended to include other kinds of data for auditing 

* or periodic logging. 

* 8author -riK. 

* ^version SF.eviaion: 1.0 $ 

* t?se* rrarconi . ras .Channel 

* ?9ince prototype vl.O 
*/ 

public class Channe IStat ist ic3 implements java . io. Serializable { 
/•• 

* Channel Td. 
•/ 

public String chan_id - "•; 
/•• 

* Usage. The current number of listeners for the specified channel. 
•/ 

public int listenerCount - 0; 

t 

/** 

* Constructor. 
•/ 

public ChannelStatistics (String id, int count) { 
chan_id - id; 
listenerCount - count; 

) 



} 
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/* marconiNet - Internet Radio Network 

* * Distributed Radio Antenna Server ( RAS ) : [Commercial Schedule v^iasai 

* $<marconi . ras . >Commercials.chedule . java -vl . 0 (prototype version), 1998/09/06 S 

• * Ojdkl.l.l, ~riK. 
V 

package marconi.ras; 

import java.io.*; 
Import java.util.*; 

/*• 

* The <code>CommercialSchedule</code> class represents a template for schedule of 

* commercial time slots. Currently, the number of commercial breaks each day and 

* the number of advertisement slots for each break are statically set, but it 

* should be extended to be more dynamic. In any event, it provides several APIs 

* for retrieving proper information from the advertisement database. 

* <p> 
* 

* Gauthor -riK. 

* ^version $Revision: 1.0 $ 

* Qsince prototype vl.O 
V 

public class Commercial Schedule { 
/* 

* An array of commercial breaks. 
*/ 

private CommercialBreak ( ] breaks; 
/** 

* Number of breaks per day. 
V 

public int N_ BREAKS = 8; 
/* 

* Break counter. 
*/ 

private int breakCounter =* -1; 
/* 

* Time-slot counter 
*/ 

private int slotCounter - -1; 
/** 

* Creates new instance of commercial schedule. Use default number of breaks. 
*/ 

public Commercial Schedule () { 



breaks - new CommercialBreak [HJBREAKS] ; 

// allocate breaks with slots 
for (int i - 0; i < NL.BREAKS ? i++> { 
breaks [i] * new CommercialBreak () ; 



/•* 

* Creates new instance of commercial schedule. This cannot be used in this 

* version because the advertisement registration protocol assumes the default 

* setting anyways. 



* 8 pa ram 
*/ 



f req 



number of breaks per day. 
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public Commercial Schedule (int freq) i 
M — BREAKS - £ req; 

breaks - new CommercialBreak [N_BREAKS 3 ; 

// allocate breaks with slots 
for (int i - 0; i < M_BREAKS; i + +> { 
breaks [i] - new CommercialBreak () ; 

} 

) 

/•* 

* Goes to next commercial break. 
*/ 

public void nextBreak ( ) { 

breakCounter = (breakCounter + 1) % N_BREAKS; 
slotCounter - -1; 

) 

/** 

* Gets the next advertisement id in schedule. 
*/ 

public String next Slot () { 
if (breakCounter < 0) { 
nextBreak ( ) ; 

> 

slotCounter « (slotCounter + 1) % breaks (breakCounter] .N_SLOTS; 

return breaks [breakCounter ] .getComrnercial (slotCounter) ; , 
] i 
/** 

* Returns the available time slots for advertisement. Each vector element is 

* associated with a commercial break, which has 8 (default) possible slots. 

* These 8 slots are represented by a <code>binary string</code> where a '1' 

* means that the slot is occupied. 
* 

* Sreturn a vector of bytes which represents the available commercial slots. 

public synchronized Vector getTimeSlots ( ) { 
Vector breakList - new Vector ( ) ; 

for (int i - 0; i < N_BREAKS; i++) ( 

breakList . addEieroent (breaks (i) .get Bitmap () ) ; 

> 

return breakList; 

) 

/** 

* Sets the requested time slot for the given advertisement. 
*/ 

public boolean setXimeSlot (int break_id, int alot.id, String ac\_id) { 
return breaks [brealc_id] .reserveSlot (slot_id, ac\_id) ; 

) 

> 

/** 

* Each commercial break consists of the following: 

* <ul> 

* <li>the number of slots for this break (does not neccessarily have to 

* be 8 but the prototype should use this default value) ; 

* <li>array of slots that contains the commercial ids; 

* </ui> 

* <p> 
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* 

* Qauthor *-riK. 

* Aversion $Reviaion; 1.0 $ 

* Qsince prototype vl . 0 
V 

class CommercialBreak { 
I** 

* The number of commercial slot3 per each break. 
•/ 

public final int N__SLOTS = 3; 
/* 

* This prototype version does not use the below parameter. . . 
* 

private Date breakTime; // beginning of the commercial break time 
•/ 

/* 

* 8-bits are used to represent 8 commercials. Each bit maps to a 30 second 

* commercial. 
*/ 

private int bitmap; 
/* 

* The array of slots that contain advertisement id. 
*/ 

private String [J slots; 

m * 

/* ; : 

* Constructor for commercial break, 

*/ 

publ- Commercial Break () { 
t -lis. bitmap » 0; 
••-lots =» new String [N_ SLOTS J ; 

) 

/* 

* Check to see if all the slots are full. 
*/ 

protected synchronized boolean isFullO { 

return (bitmap >- (1 « N_SL0TS) - 1) ? true : false; 

) 

/* 

* Get the bitmap representation of the slots. 
*/ 

protected String getBitmapO ( 

return Integer .t oBinary St ring (bitmap) ; 

) 

/* 

* Set the bit for tbe requested time slot. Slots are of course 0-based (0 - 7) . 
*/ 

protected synchronized boolean re serves lot (int slot. String ad_id) { 
if (isFullO) { 
return false; 

} 

int slot_£it - 1 « slot; 
if ((bitmap 6 slot_Jbit) > 0) { 
return false; 

> 

else ( 
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bitmap |- Ji!ot_bit; 
slots [slot] - ad_id; 
return true; 

> 

} 

/* 

* Reserve any available time slot; 
V 

protected synchronized boolean reaerveSlot ( String ad_id) { 
if (this.isFull () ) { 
return false; 

} 



boolean success « false; 

for (int i » 0; i < N„SL0TS; i++) ( 

if (slots [i] null) ( 

bitmap |= 1 << i; 

slots [i] * ad_id; 

success =» true; 

break; 

> 

} 

return success; 



/* 

* Get the specific commercial. 
*/ 

protected synchronized String get Commercial (int slot) { 
return slots [ slot 1 ; 

} 
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/* roarconiNet - Internet Radio Network 
- Distributed Radio Antenna Server (RAS) : (RAS Action Handler) 
* 

. * 5<marconi.ras.>RASActionHandier . java -v2 . 0 <protot ype version), 1998/02/17 $ 

* Qjdlcl.2, -nK. 
*/ 

package marconi .raa; 

import java.awt.*; 
import java . a«t .event . • ; 

/** 

* This class handles two action commends, particularly <code>Ok</code> and 

* <code>Toggle< /code> buttons. 
*/ 

public class FASAct ior.H«ndlor ( 

public statLZ Aciionlxstenor buttonControl - new ActionListener ( ) { 
public vji(J lonNr f omed (ActionEvent e) { 
String cc*w»*i:tJ - « .Q*t ActionCommand ( ) ; 
if (rcw4ftd.»?j«:i( - Ok*») { 

RASCcnt rols .processCommand () ; 

) 

else if < co**J»*r*a "Toggle" ) ) { 

RAS Cent ro.i.t 075 1 • But ton ( ) ; 

} 

else if uoi*iftd.e^«;il'Ad<i Commercial")) { 
ADCact eel »Add<) ; 

> 

else if icom«rvd.#<>al« < "Submit Commercials")) { 
ADC out roll . prices » Submit () ; 

) 

else if <co»*fw4.#q>*ai« ("Remove Commercials")) { 
ADCont co:a .pcxtuMaove () ; 

} 

) 

public static Act icfCistecer listControl - new ActionListener O ( 
public void act icnPerformed (ActionEvent e) { 

if (RASContcols, act lonDisplay. equals ("Add") ) { 
RASCont rol • . er.t ry_ 1 . setText 

(WtSOi r •ctory. direct or yLiat_l .getltem 

( RASO 1 r •« ory. direct or y Li st_l .getSelectedlndex O ) ) ; 

} 

) 

}; 
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/* marconiNet - Internee Radio Network 

* Distributed Radio Antenna Server (RAS) : [RAS GUI Controls] 
» 

* $<marconi.ras.>RASControls. java -v2 . 0 (prototype version), 1999/02/15 $ 

* @jdkl.2, TiK. 
V 

package marconi . ras; 

import java.awt.*; 
import java.awt .event .*; 
import java.util . *; 

/** 

* This panel contains user interfaces to the applet. 

public class RASControls extends Panel ( 
public static RASMgrApplet owner; 
public static Choice ids; 
public static TextField entry.l; 
public static Button button.l; 
public static Button button. 2; 
public static String actionDisplay; 
private static int WIDTH - 600; 
private static int HEIGHT - 50; 

/** 

* Instantiates the control panel. 
V 

public RASControls (RASMgrApplet main) { , # 

owner - main; , * 

actionDisplay - "Add"; 

GridBagLayout grid - new GridBagLayout <) ; 
GridBagConstraints cons - new GridBagConstraints <) ; 
setLayout (grid) ; 

cons -fill - GridBagConstraints. NONE; 
cons.weightx - 0.0; 

// define toggle button 

button_l = new Button <" * + actionDisplay + " "); 
button.l .setActionComraand( "Toggle") ; 

button_l .addActionListener (RASActionHandler .buttonControl) ; 

button. 1 .setBackground (Color. lightGray) ; 

// button_l- setBackground (Color. black) ; 

button_l .setForeground (Color -black) ; 

// button — 1 .setForeground (Color. red) ; 

add (butt on_l) ; 

validate ( ) ; 

// channel id 

ids - new Choice O; 

updatelDsO ; 

grid. 3et Constraint a (ids, cons) ; 
ids . setForeground (Color . black) ; 

// ids. setForeground (Color, yellow, darker () ) ; 

ids . setBackground (Color . lightGray) ; 

// ids . setBackground (Color .black) ; 

add (ids) ; 

validate () ; 

// selected station (multicast address + name) 

entry.l «■ new TextField (30 ) ; 

grid, set Constraints (entry — 1, cons) ; 

entry__l . setForeground (Color .black) ; 
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/ / entry^l . setForeground (CoLor.yellow.de 

entry.l • setBackground (Color . gray .brighter () ) ; 

// entcy_l . aetBackground (Color .blue . darker ( ) .darker < ) ) ; 

add(entry_l) ; 
validate () ; 

// add global to local 

cons.gridwidth » Gr idBagConatraints . REMAINDER; 
button_2 - new Button(" Ok "); 
button_2 . setActionCommand ( "Ok" ) ; 

but t on_2 . addAct i onLi stener ( RASAct ionHandler . butt onCont rol ) ; 

button_2 .setBackground (Color . lightGray) ; 

// button. 2 . setBackground ( Col or. black) ; 

button_2 . set Foreground (Color .black) ; 

// button_2 . setForeground (Color .red) ; 

grid.setConstraints (button_2, cons) ; 

add(button_2) ; 

validate () ; 

// resize 

setSize (WIDTH, HEIGHT) ; 

} 

/** * 
* Carries,, out the specified action. 

*/ 

public static void proceasCommandO { 

//if action is "Add" m * 

if (actionDisplay. equals ("Add - ) ) { f I 

String textfield - entry — 1 . get Text () ; 

String id — str - ids .getSelectedltera () ; 

if (textfield. indexOf <", ") > 0 66 id_str !- null) { 

StringTokenizer dir - new StringTokenizer (textfield, •, *); 
String ma - di r. next Token () ; 
String name =» dir . nextToken () ; 
int id - Integer. parselnt (idLstr) ; 
if (owner. addChannel (id, ma) ) ( 

owner. showMessage ("Added new channel...*, false); 

update IDs <) ; 

) 

else { 

owner .showMessage ("Channel could not be added... % true); 

} 

> 

else ( 

owner. showMessage ("Select a station from global directory.", true); 

) 

} 

// if action is "Remove* 

else if <act ionOiapl ay ♦ equals ("Remove") ) ( 
String ioL_str - ids ♦getSelectedltem () ; 

if (idt_str !- null) { 

int id - Integer, parse I nt (idL-Str) ? 
if (owner .removeChannel (id) ) { 

owner .showMessage ("Removed channel " + id + false); 

update IDs () ; 

) 

else < 

owner .showMessage ("Channel could not be removed. true) ; 
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> 

else { 

owner . showMes sage ( "No channel to remove ... " , true); 

> 

) 

II clear input fields 
entry_i .setText C") ; 

> 

/** 

* Implements tr.e toggle mechanism for the control button; 
*/ 

public static void toggleButton () { 

// if ottton label says •Add", change it to "Remove" 
if (act lonCiaplay. equals { "Add") ) { 
actionDiaplay - •Penove"; 

owner . snowweasage ("Please select a channel to remove...", false); 
update ICs ( ) ; 

) 

// if button says "Remove", change it to "Add" 

else if : act i orDispl ay .equals ("Remove") ) { 
actional »pla/ - "Add"; 

owner . sho~*«*»age I "Please select a station to add...", false) ; 
updateXCs i i . 

> 

# * 

button_l . setl-a&el (actionDiaplay) ; , , 

) 

/*• 

* Updates available channel ids. 
*/ 

public static void update J DtW ( 
ids . removeAl 1 1) ; 

if (actionDisplay .equals ("Remove") ) { 

for (int i - C; i < owner. channellDs. length? i++) { 
if (owner . clvannellDs [ i] ) { 

ids .add (String .valueOf (i) ) ; 

} 

} 

} 

else i 

for (int i-O; 1 < owner .channel IDs . length; i++) { 
if (! owner. channel IDs [i)) < 

ida.e*d(String. valueOf (i) ) ; 

> 

) 

) 

) 

) 
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. /* marconiNet - internet Radio Network 

* Distributed Radio Antenna Server (RAS) : IRAS Directory Controls) 

* S<marconi . ras . >RASDirectory . j av a -v2 . 0 (prototype version), 1999/02/15 $ 
" * 0jdkl.2, -nK. 

"/ 

package macconi.raa; 

import java.awt.*; 
-mport java . aw; .event .* ; 
import }ava . util . Enumeration; 
import java. io. •; 
import marconi .util . * ; 

/•• 

* This panel contains user interfaces to the applet. 
•/ 

puolic class RASOirectory extends Panel 
implements Punnable { 

/•• 

• This thread periodically downloads global channel announcements (CAP) cache. 
■/ 



private Thread g_di rectoryThread « null; 
/•• 

* This thread updates the announcements for the locally supported channels. 
•/ 

private Thread l__di rectory Thread - null; 
/•• 

* The global announcement update interval. 
•/ 

private static long G_UPDATE - 20000; 
/*• 

* The local announcement update interval. 
*/ 

private static long L_UPDATE - 20000; 

public static RASMgr Applet owner; 
public static Label label_I; 
public static List directoryList_l; 
public static Label label_2; 
public static List directoryList_2 ; 
private static int WIDTH - 600; 
private static int HEIGHT - 200; 

/•* 

* The file dump. 
V 

public final static File file - new File ( mapsta") ; 

* Instantiates the directory display panel. 
*/ 

public RASDi rectory (RASMgr Applet main) { 
owner - main; 

GridBagLayout grid - new GridBagLayout ( ) ; 
GridBagConstraints cons - new GridBagConstraints () ; 
setLayout Igrid) ; 

cons. fill • GridBagConstraints .NONE; 
aetFont(new Font ( "Helvetica*,. Font. BOLD, 24)); 
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// label 1 
cons.weightx - 1.0; 
labels 1 - new Label () ; 

label_l .set Text (• Global Channel Directory •) ; 

grid . setCqnstraints (label_l , cons) ; 

label_l .setForeground (Color .black) ; 

// label_i. setForeground (Color . white) ; 

adddabel.l) ; 

validate () ; 

// label 2 

cons .gridwidth = GridBagConst raint 3 . REMAINDER; 
label_2 - new Label <); 

iabel_2.setText (■ Local Channel Directory •> ; 

grid. setConstraints (label_2, cons) ; 

label_2 . setForeground (Color .black) ; 

/ / label_2 . setForeground (Color . white ) ; 

add(latoel_2) ; 

validate < ) ; 

setFont (new Font ( "Helvetica" , Font. PLAIN, 14)); 
// list 1 - global 

cons . gridwidth « GridBagConst raint 3 . RELATIVE; 
directoryList_l - new List (10, false); 

directoryList_l . addAct ionListener (RASActionHandler . listControl) ; 
grid . setConstraints (directoryList_l, cons) ; 
directoryl.ist_l . setForeground (Color .black) ; 
directory List_l . setBackground (Color .white) ; 

// directoryList_l .setForeground (Color .yellow. brighter {)) ; * 

// directoryList_l .set Background (Color . darkGray) ; , 

add (di recto ryLiat_l) ; 
validate < ) ; 

// list 2 - local 

cons .gridwidth - GridBagConst raint 3 . REMAINDER; 
directoryList_2 - new List (10, false); 

// direct oryList_2 .addAct ionXi st ener (RASActionHandler . listControl) ; 

grid . setConstraints (directoryList — 2, cons ) ; 
directoryl*ist_2 . setForeground (Color .black) ; 
direct oryList. 2 . setBackground (Color .white) ; 

// direct oryList_2 .setForeground (Color .yellow. brighter () ); 

// directorylist_2 .setBackground (Color. darkGray) ; 

add <directoryList — 2) ; 
validate () 7 

// resize 

setSi re (WIDTH, HEIGHT); 
start: <) ; 



/** 

* Starts the directory update. 
*/ 

public void start <) ( 

g_di rectory Thread - new Thread (this) ; 
g_di rectory Thread, start () ; 
l_directoryThread - new Thread (this) ; 
Indirect oryThread. start () ; 



* The run methods for the two threads. 
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public void runO { 

// global directory 

while (Thread. currentThread ( ) ™ g_ direct oryThread) { 
PrintWriter fout - null; 

try I 

Thread- sleep <G_ UPDATE) ; 

fout - new PrintWriter (new Buff eredWriter (new FileWriter (f ile) ) ) ; 
Enumeration enum - owner . rasServer .downloadCAP ( false) . elements () / 
Vector2 ip_addr = new Vector2(); 
Vector2 name =* new Vector2(); 

while (enum. hasMoreElements () ) ( 

CDPPacket cdp =» (CDPPacket) enum. nextElement () ; 

ip_addr . addElement ( cdp . MADDR) ; 

name . addElement (cdp . name) ; 

fout .print In (cdp. MADDR *■ ■ " + cdp. name) ; 

) 

displayDirectory (ip_addr . toStringArray ( ) , name . toSt ringArray ( ) ) ; 
fout .close ( ) ; 

} 

catch (Exception e) { 

e .printStackTrace ( ) ? 

) 

> 

// local directory , * 

while ( Thread . cur rent Thread ( ) — Indirect oryThread) { , * 

try ( 

Thread, sleep <L_UPDATE) ; 

Enumeration enum =» owner . rasServer . downloadCAP (true) .elements <) ; 
Vector2 ip_ addr - new Vector2(); 
Vector2 name » new Vector2(); 
Vector2 id - new Vector2<); 

while (enum. hasMoreElements () ) < 

CDPPacket cdp - (CDPPacket) enum. nextElement (} ; 
ip_addr . addElement ( cdp . MADDR) ; 
name . addElement (cdp . name ) ; 
id . addElement ( cdp . id ) ; 

} 

displayDirectory (ip_addr . toStringArray ( ) , name. toStringArray ( ) , 
id. toStringArray () ) ; 

} 

catch (Exception e) { 
> 

) 

} 

protected static void displayDirectory (String [] ip_addr, StringO name) { 

if (direct oryList_l. get itemCount () > 0) 

direct oryList_l . removeAll () ; 
for (int i e 0; i < ip_addr . length; i++) { 

direct oryList_l. add (ip_addr [i] + m , 9 + name(i]); 

) 

) 

protected static void displayDirectory (StringU ip_addr, StringO name, StringI] id) 
if (directoryList.2 .get ItemCount () > 0) 

directory Lis t_2 . removeAll () ; 
for (int i - 0; i < owner .MAX.CBANNELS; i++) { 
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directoryLi 3 t_2 .add (String -valueOf (i) ) ; 

) 

for (int 1=0; i < ip_addr. length; { 

directoryList_2 . replaceltem (idfij + " " + ip__addr[i] + • * name[il. 

Integer .parselnt <id(il ) ) ; 

) 

> 

protected static void diaplayDirectory <St ring ip_addr, String name) { 
directoryList__l .add(ip_addr + ■ + name); 

> 

protected static void diaplayDirectory (St ring ip_addr, String name, String id) { 
directoryList_2 . replaceltem ( id + ip_addr + " , " + name. Integer .parselnt ( id) ) 

} 
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/* marconiMet - Internet Radio Network 

* Distributed Radio Antenna Server (RAS) : [RAS Manager Interface} 
* 

* $<marconi . ras . >RASManager . java -v2 . 0 (prototype version) , 1999/02/15 $ 

* Qjdkl.2, -riK. 
*/ 

package marconi.ras; 
import java.rrai.*; 
/** 

* This interface is provided for the RAS to write alarming texts at the remote manager. 
* 

* ^author -riK. 

* ^version SRevision: 1*0 $ 

* @see marconi . ras .MarconiServer 

* Gsince prototype vl.Q 
*/ 

public interface RASManager extends Remote { 
/** 

* Write various messages (error messages) - 
•/ 

public void showMessage (String msg, boolean blink) 
throws RemoteException; 

> 
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'» marconiNet - Internet Radio Network 

* Distributed Radio Antenna Server <FAS> : (PAS Mess age board Display] 
* 

* $<marconi . ras , >RASMessageBoard . java -v2 . 0 (prototype version), 1999/02/15 $ 

* Qjdkl.2, -riK. 
*/ 

>ackage marconi.ras; 



.mport java.awt.*; 
import java.net.*; 
import java - applet .* ; 



* This message borad is used to display messages in a scrolling fashion. 

* The content of the message is updated by directly accessing and changing 

* the public variables <code>text</code> and <code>bl ink</code> . 

* If <code>blink</code> is set to <code>true</code>, the message stored in 

* <code>text</code> will scroll and also 'blink!; this feature is 

* particularly for alarm (error) messages. 
*/ 

public class RASMessageBoard extends Applet 
implements Runnable ( 

// publically accessabie vars 

public String text - 

public boolean blink = false; 



// awt vars 

int shiftCnt - 0 ; 

private Font font; 

private static Color fgcolor - Color. blue; 
private static Color bgcolor =* Color .lightGray; 
private Color color - fgcolor; 
private Image offScrlmage - null; 
private Graphics of f ScrGraphics « null; 
private Dimension offScrSize » null; 

Thread thread - null; 



* Even though this object extends from an applet, it is not to be 

* the main applet and thus is instantiated via a constructor; you may 

* set it to display some initial text; 
*/ 

public RASMessageBoard (String initial_text) { 

// initialize text field 
this. text - initial_text; 



// measure screen width 
shiftCnt - getSize () .width; 



// setup font 

font - new Font ("Helvetica* , Font.PIAIN, 16); 
setFont (font) ; 
start <) ; 

} 

/** 

* Start the thread; 
*/ 

public void start () { 

if (thread — null) { 

thread - new Thread (this > ; 
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thread- start () ,* 

/** 

* Stop the thread; 
*/ 

public void 3top() { 
thread =» null; 

} 

/** 

* Thread body; blinking feature is implemented by toggling text color 

* b/w background and foreground here after each pause; 
*/ 

public void run O { 
int i 0; 

while (Thread. currentThread ( ) « thread) i 

// pause 
try { 

Thread. currentThread { ) .sleep (200) ; 

) 

catch (InterruptedException e) ( 
\ 

// blink -> toggle colors b/w black and yellow 

// it remains black for 2 pause periods and yellow for 4 periods 
// otherwise -> stay yellow 
if (blink) 

color =■ (i++ < 2) ? bgcolor : fgcolor; 

else 

color * fgcolor; 

// update drawing 
repaint () ; 

i - U > 6) ? 0 : i; 

} 

\ 

/** 

* Update display (move the message to the left) . 
V 

public synchronized void update (Graphics 9) { 
FontMetrics metric; 
f Metric - getFontMetrics (f ont) ; 
Dimension d — get Size (); 

// create off -screen image 

if ( (offScrlmago — null) II (d. width !- of fScrSixe .width) II 
(d. height !- off ScrSize .height) ) { 
offScrlmage » createlmage (d. width, d. height); 
offSerSize - d; 

of f ScrGraphics - of fScr Image . getGraphics () ; 
off ScrGraphics. setFont (font) ; 

) 

// setup off -screen image 

of f ScrGraphics . setColor (bgcolor) ; 

off ScrGraphics. fillRect (0, 0, d. width, d. height ) ; 
of f ScrGraphics . setColor (color) ; 
of f ScrGraphics . setFont (font ) ; 

if ((ahiftCnt + fMet ric . string Width (text) ) <- 0) 
shiftCnt - d. width; 
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// shift left & write message 
shiftCnt - shiftCnt - 5; 

of fScrGraphics .drawstring (text , shiftCnt, (int) (d. height * 0.65)); 
g .drawlmage (of £ Scrlmage, 0, 0, null); 
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/* marconiNet - Internet Radio Network 

* Distributed Radio Antenna Server (RAS ) : [RAS. Manager Applet] 

* $<marconi . ras . >RASMgrApplet . java -v2 . 0 (prototype version), 1999/02/15 $ 

* <3jdkl.2, -rxK. 
*/ 

package marconi.ras; 

import java . applet ; 
i-mport java.awt.*; 
import java.util.*; 
import java . net . URL; 
import java.rmi.*; 
import java . rrni . server .* ; 

/** 

* This applet is used by a RAS manager (operator) who monitors and configures 

* the MarconiServer . 

* Gauthor -riK. 

* Aversion $Revision: 1.0 S 

* Usee marconi . ras .MarconiServer 

* Gsince prototype vl.O 

public class RASMgrApplet extends Applet 

implements RASManager, java . io . Serializable { 

// miscellaneous variables 
private static int width =• 0; 
private static int height - 0; 
protected RAS rasServer - null; 
protected int MAX_CHANNELS - 0; 
protected static boolean (] channellDs; 

final static String obj_name « "marconi . ras . RASMgrApplet"; 
// tools 

RASDirectory directory « null; 
RASControls controls = null; 
ADControls ad_controls - null; 
RASMessageBoard msgBoard « null; 

/** 

* Initialize the applet and setup display area. 
V 

public void init() { 
try { 

width « Integer. parselnt (get Parameter ("APPLWIDTH") ) ; 
height - Integer * parselnt (get Parameter ( "APPLHEIGHT") ) ; 

// lookup RAS (MarconiServer) 
URL URLbase - getDocumentBase ( ) ; 

System, out .print In (obj__ name + Vinit: locating RAS*) ; 

rasServer - (RAS) Naming. lookup (" //■ + URLbase .get Host <> + ■:* 

+ getParameter ("RASPort") 
+ "/marconi .ras. MarconiServer" ) ; 

// init variables 

MAX_CHANNELS = MarconiServer . MAX_CHANNELS ; 

} 

catch (Exception e) { 
// fatal error 

System. err .print In (ob j_ name ♦ ".init: "); 
e, print StacJcTrace () ; 

> 
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channeiXDs - new boolean [MAX_CHANNELS ] ; 
for (int i =• 0; i < channellDs . length; i++) { 
channellDs [ij » false; 

) 

// draw display area 
aetupDisplay 0 ; 

) 

/** 

* Disolay the applet. 
*/ 

public void setupDisplay ( ) { 
Label label_l; 

setBackground (Color. lightGray ) ; 

directory =* new RASDirectory (this) ; 
controls a new RASControls (this) ; 
ad_controls =» new ADControls ( this) ; 

msgBoard « new RASMessageBoardClnitializing RAS ..."); 
GridBagLayout grid - new GridBagLayout () ; 
GridBagConstraints cons =» new GridBagConstraints < ) ; 

// setup grid 

int rowHeightsU - ( 10, 200, 50, 200, 90); 
grid.rowHeights - rowHeights; 
setLayout (grid) ; 

cons. fill » GridBagConstraints. BOTH; 
// label 1 

Font font - new Font ("Arial", Font. BOLD, 24); 
setFont (font) ; 

cons .gridwidth =» GridBagConstraints .REMAINDER; 
label_l = new Label RAS MANAGER Label .CENTER) ; 

grid. setConstraints (laJbel_l, cons) ; 
label_l .setForeground ( Color .black) ; 
add(label_l) ; 
validate ( ) ; 

setFont (new Font ( "Arial", Font. PLAIN, 14)); 
// add directory lists 

cons .gridwidth = GridBagConstraint s . REMAINDER; 
cons.weightx » 1.0; 
cons .gridheight - 1; 

grid. setConatraint s (directory, cons) ; 
add (directory) ; 
validate () ; 

// add controls 

cons . gridwidth - GridBagConstraints .REMAINDER; 
cons.weightx -1.0; 
cons .gridheight - 1; 

grid. setConstraints (controls, cons) ; 
add (controls) ; 
validate () ; 

// add ad-insertion controls 

cons . gridwidth — GridBagConstraints . REMAINDER; 
cons.weightx - 1.0; 
cons. gridheight - 1; 

grid. setConstraints (ad_controls, cons) ; 
add (adL_controls ) ; 
validate 0 ; 
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// add message scroller board 

cons .gridwidth - GridBagConst raints . REMAINDER; 
cons.weightx — 1.0; 
cons. weighty ■ 1.0; 
cons.gridheight = 1; 

grid. setConst raints (msgBoard, cons); 
add (msgBoard) ; 
validate () ; 

resize (width, height); 

} 

/•* 

* Close down the server when closing applet. 

public void destroy {) { 

if trasServer i a null) ( 
try ( 

rasServer . shutdown ( ) ; 
remove (directory) ; 
remove (msgBoard) ; 
remove (controls) ; 

) 

catch {RemoteException e) { 
e .print St ackTrace ( ) ; 

) 

> 

) 

/•* 

* Register channel with the server. 
*/ 

public boolean addChannel (int id, String ip) { 
boolean status ~ false; 
try { 

status - rasServer .registerChannel (id, ip) , 

} 

catch (RemoteException e) { 
e.printStackTraceO ; 

> 

if (status) { 

channellDs [id] «■ true; 
update_ctrls <) ; 

> 

return status; 

} 

/** 

* Remove channel £ro*% the server. 
*/ 

public boolean removeChannel (int id) { 
boolean status - false; 
try { 

status ■» rasServer . rercoveChannel (id) ; 

> 

catch (RemoteException e) \ 
) 

if (status) < 

channellDs [id] - false; 
update_ctrls ( ) ; 

> 

return status; 
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* Update tools upon action taken. 
-/ 

private void update_ctr Is < ) { 

t / controls. update IDs () ; 

ad_controls .updatelDs < ) ; 

> 

/*• 

* Write vancus messages (error messages) . 
•/ 

public void showMessage (String msg, boolean blink) { 
nts^Board . text - msg; 
rftacBoard.fclink - blink; 

) 

/** 

* Return applet information. 
*/ 

public Strir.^ ?et Applet Inf o ( ) { 

return *AA5 :cnf igurat ion/management tool"; 

> 
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/* marconiNet - Internet Radio Network 

* Distributed Radio Antenna Server (RAS ) ; [RTSP Server Controller] 

* 5<narconi.ras.>RTSPServecControl. java -v2 . 0 (prototype version), 1998/1/12 S 

* Gjdkl.2, -riK. 
•/ 

package marconi . ras; 

import java. io.*; 
import java. net**; 
import 3ava.util.*; 

/ • • 

* This class provides interfaces to manipulate the remote RTSPServer. 

* <p> 

* 3author -nK. 

* ^version SR«vision: 1.0 $ 

* Ssee narconi . ras . MarconiServer 

* 6since ptotctype 1.0 
•/ 

public class RTSFServerControL { 
/• 

• RTSPServ«r private info. 
•/ 

private final static String obj_name =* "marconi . ras . RTSPServerCont rol" ; 
pcivdte final static int TOR_OFFSET - 0; 
private final static int M_0FFSET - 4; 

private final static int LK_OFFSET — 8; #, 
private final static int PATH_OFFSET - 12; t , 

/•• 

* The RTSPServer Host. 
*/ 

protected String hostname; 
/** 

* The RTSPServer port, 
protected int port; 

/* 

* TCP-Client resources for comrauni catling with the RTSPServer. 
*/ 

private Socket rtsp_aoc)c - null; 

private Buf f eredlnputStreara rtsp_ in - null; 

private Buf f eredOutputStream rtsp_out — null; 

/** 

* Type of request field value <code>start</code> . 
*/ 

protected final static byte T0R_START - 1; 
/** 

* Type of request field value <code>stop</code> . 
*/ 

protected final static byte T0R_ STOP - 2; 
/** 

* Type of request field value <code>coironercial</code>„ 
*/ 

protected final static byte TOR_COMMERCIAI. - 3; 
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/•* 

* Returned status value <code>ok</code> . 
*/ 

protected final static byte STATUS_OK - 0; 
/** 

* Returned status value <code>error</code> . 
*/ 

protected final static byte STATU S_ERR * 1; 
/** 

* Returned status value <code>duplicate</code> . 
*/ 

protected final static byte STATUS_DUP *» 2; 
/** 

* Returned status value <code>states full</code>. 
*/ 

protected final static byte STATUS_FUL - 3; 
/*• 

* The number of bytes returned by RTSPServer. 
V 

protected final static int RECEIPT_LEN = 1; 
/** 

* Creates an object that will interface with the RTSPServer. 
*/ 

public RTSPServerControl (String rtsp_h, int rtsp_p) { *. 
this .hostname » rtsp_h; ## 
this .port ■ *"tsp_p; 
try \ 

this . rtsp — sock - new Socket <rtsp_h, rtsp_p) ; 

this.rtsp_in » new Buf f eredlnputSt ream (rtsp.sock . get Input Stream () ) ; 
this . rtsp_out - new Buf f eredOutput St ream < rtsp_30ck . getOutputSt rea/a < ) ) ; 

} . 

catch (lOException e) { 

) 

> 

* Signals the RTSPServer to start a new thread to support the specified channel. 

* fiparara g_maddr global multicast address* 

* @param 1 — maddr local multicast address. 

* <? return byte representing the status returned from RTSPServer. 
*/ 

public byte startChannel (Inet Address global_addr # InetAddress locals addr) { 
byte [ ] requestPkt; 
byte [J receiptPkt; 
int n - Of 

// compose outgoing packet 6 send 
requestPkt » encode (TOR^START, 

global.addr. get Address () , 

local_addr .getAddress () , 

null); 

try { 

rtsp_out .write (requestPkt, 0, requestPkt. length) ; 

) 

catch (lOException e) < 

System. err .println (obj_name * •.startChannel: ■ ♦ e.getMessage < ) ) ; 
e .print StackTrace < ) ; 

} 
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// read the status returned by RTSPServer 
receiptPkt « new byte [RECEIPT_LEN) ; 
try { 

n » rtsp_in. read (receiptPkt, 0, RECEIPT_LEN) ; 

) 

catch (iOException e) { 

System. err .print In (obj_name + " .startChannel : " + e . getMessage ( > ) ; 
e . printStackTrace ( ) ; 

) 

if (n < RECEIPT_LEN) { 

System. err. print In <cbj_name + " . startChannel : returned byte is corrupted. •) ; 
return < STATU S_ERR) ; 

> 

// return status 
return < receiptPkt [0 ]) ; 

) 

/*• 

* Signals the RTSPServer to stop the specified channel. 
* 

* (3 par am l_maddr Local multicast address. 

* G return byte representing the status returned from RTSPServer. 
*/ 

public byte stopChannel ( InetAddress local_addr) < 
byteM requestPkt; 
byte[) receiptPkt ; 

int n - 0; , 

9 

// compose outgoing packet & send 

requestPkt - encode <TOR_STOP, null, local_addr .get Address () , null); 
try { 

rtsp_out .write (requestPkt, 0, requestPkt . length) ; 

> 

catch (IOException e> { 

System. err .println (obj_name ♦ ".stopChannel: " + e .getMessage ()) ; 
e . print St ackTrace () ; 

) 

// read the status returned by RTSPServer 
receiptPkt - new byte [RECEIPT_LEN] ; 
try { 

n =» rtsp_in.read(receiptPkt, 0, R£CEIPT_LXN) ; 

} 

catch (IOException e) < 

System. err .println <ob j_ name + •.stopChannel: ■ + e. getMessage O ) ; 
e . printStackTrace ( ) ; 

) 

if (n < RECEIPT_J*EN) { 

Syst em. err .println <obj_name + ".stopChannel: returned byte is corrupted. - ); 
return (STATUS_ERR) ; 

> 

// return status 
return ( receiptPkt [ 0 ] ) ; 

} 

/** 

* Signals the RTSPServer to play the given commercial. 
* 

* (J pa ram l_maddr local multicast address. 

* 6 pa ram path commercial file path. 

* Qreturn byte representing the status returned from RTSPServer. 
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•/ 

public byte playCommercial ( InetAddress local_aciclr r String path) { 
byte (J requeatPkt; 
byte [ ] receiptPkt ; 
int n - 0; 

// compose outgoing packet & send 

requestPkt - encode (T0R_C0MMERCIAL, null, locals addr . getAddr ess () , path) ; 
try < 

rtsp_out .write (requestPkt, 0, requestPkt . length) ; 

) 

catch (IOException e) { 

System, err . prmtln (obj_name +• ■. play Commercial : • + e . qetMessage ( ) ) ; 
e.printStackTrace ( ) ; 

) 

// read the status returned by RTSPServer 
receiptPkt = new byte [R£CEIPT_LEN) ; 
tiy < 

n = rtsp_in.read(receiptPkt, 0, RECEIPT_LEN) ; 

) 

catch (IOException e) { 

System, err . prmtln (obj_name 

+ • .playCcramercial : " + e .getMessage < ) ) ; 
e . print St ackTr ace ( ) ; 

> 

if (n < RECEIPT_LEN) { 

System, err .prmtln (ob j_name 

+ " .playComnerical : returned byte ia corrupted. •); a * 

return (STATUS_ERR) ; \ 
) f " 

// return status 
retgrn (receiptPkt [01 ) ; 

I 

/** 

* Encodes the input parameters into a TCP packet. 
*• 

* Qparam tor type of request. 

* Q pa ram ra_addr global multicast address for a station. 

* @ pa ram lm_addr local multicast address for a station. 

* Gparara path commercial file. 

* Q return the encoded byte array buffer. 
*/ 

static bytelJ encode (int tor, byte[] m_addr, byte[) lnv_addr, String path) ( 
int path_len - (tor TOR^COMMERCIAL) ? path, length < ) : 0; 
byte[] buffer - new byte [PATH_OFFSET + 

((tor — TOR^.COMMERCIAL) ? path_len : 1)1; 

// type of request 

buffer [TOR_OFFSET + 0) - (byte) ((tor « 16) »> 24); 
buffer fTOR^OFFSET + 1J - (byte) ((tor « 24) »> 24); 

// path length 

buffer [TOR^OFFSET + 21 * (byte) ( (path_len « 16) »> 24); 
buffer [TOR_OFFSET + 31 - (byte) ( <path_len << 24) »> 24); 

// M: global multicast address 
if (tor — 1) < 

System, ar ray copy (m_addr, 0 r buffer, M—OFFSET, n^addr . length ) ; 

} 

// lm: local multicast address 
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System, arraycopy < lm_addr, 0, buffer, LM_OFFSET, lm_a< 

// commercial file path... 
if (tor — 3) { 

byteU pathbuf - path . getBytes { ) ; 

for (int i - 0; i <: pathbuf . length; i + + ) { 
buffer {12 + i) - pathbuf [i]; 

} 

> 

return buffer; 

) 

/"* 

* Decode the status value. 
*/ 

public static String decodeStatus (byte status) { 
switch (status) { 
case 0 : return "OK" ; 
case 1: return "ERROR"; 
case 2: return "DUPLICATE" ; 
case 3: return "STATES_FULL"; 
default: return *UNKNOWN_STATUS«" + status; 
> 

) 
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/* marconiNet - Internet Radio Network 

* Distributed Internet Radio Server (DIRS) : (LAS interface] 
* 

* 5<marconi->LAS . java -vl . 0 (prototype version), 98/8/19. 

* 6jdkl.2, -riK. 
V 

package marconi.ras; 

import java.rmi.*; 
import java.util. Vector; 

/** 

* The LAS (local advertisement server) remote interface provides interfaces 

* for the advertising company, to store and broadcast local commercials. 
V 

public interface LAS extends Remote { 

// public int uploadCommercial (byte (] file) 
// throws RemoteException; 

// public Vector reviewTimeSlot s (int channel) 
// throws RemoteException; 

/** 

* Tell the ad server to reserve a slot, 
•/ 

// public boolean buyCommercialTime (int channel. String adL_id) 
// throws RemoteException; 
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/* marconiNet - Internet RadTo Network 
- * Distributed Radio Antenna Server (RAS) : [RAS Implementation] 

* 5<marconi . ras . >MarconiServer , java -v3 . 0 (prototype version), 1998/12/22 S 
" * 9jdkl.2, -riK. 

' V 

package marconi . ras ; 

import java . rrni . * ; 

import java. rnti .server . *; 

import java. rrni .registry . LocateRegistry; 

import java . net . * ; 

import java.util.*; 

import java . io . * ; 

import marconi . util . *; 

/•• 

* The <code>MarconiServer</code> class implements the interfaces <code>RAS</code> 

* (radio antenna server) and <code>LAS</code> (local advertisement server) . 

* As a RAS, it should manage a particular set of multicast channels that are 

* active and allow the IRCs (internet radio clients) to be able to tune to 

* each channel. The LAS server provides an API-like interface to the advertising 

* companies, tt also maintains a local database to store the commercials . 

* <p> 

* 0author -riK. 

* Sversion SRevision: 1,0 S 

* 9 see marconi . ras .Channel 

* Bsince prototype 1.0 
*/ 

public class MarconiServer extends UnicastRemoteOb ject 

implements RAS, Runnable ( // this version doe9 not implement LAS yet 

/* 

* Radio Antenna Server local id 
*/ 

final String name » •marconiNet: RAS, the radio antenna server/MarconiServcr B ; 
final static String obj_narae - "marconi . ras .MarconiServer - ; 
private String hostname — null; 

/** 

* The hard-coded port number for local RMI registry. 
*/ 

public final static int RMI__PORT • 5678; 
/** 

* The multicast address used for global announcement of CDP packets. 
V 

public final static String GLOBAL_CAP - "225.3.0. 0"; 



/•■ 

* The 
*/ 
public 



multicast address used for local announcement of COP packets. 



final static String LOCAI«_CAP - "225. 3. 0.1"; 



/** 
* The 

V 
public 



port used for channel announcement protocol (CAP) • 



final static int CAP_P0RT - 7777; 



/-* 
• The 
-/ 

public 



port used for multicast communication between RSC and RAS a . 



final static int RSC_PORT - 8910; 
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/** 

* The port used for multicast communication between RAS and iRCs. 
*/ 

public final static int IRC_PORT » 8 910; 
/** 

* The default TCP poet used for communicating with the RTSPServer. 
*/ 

public final static int RTSP_PORT = 8765; 
/** 

* The ttl used for multicast from RSC to RASs. 
*/ 

public final static int GLOBAL_TTL « 128; 
/** 

* The ttl used for multicast from RAS to IRCa . 
*/ 

public final static int LOCAL_TTL « 16; 
/** 

* The maximum number of channels that can be supported locally (finite number 

* of channels) . 
•/ 

public final static int MAX_C HANNE L S - 20; 
/** 

* The maximum media content payload length in bytes <«RTP payload length) . 
*/ 

public final static int MAX_PAYLOADLEN - 4 096; * 
/** 

* The maximum RTP header length. 
*/ 

public final static int MAX_ RTPHDRLEH - 20; 
/** 

* This thread receives channel announcements and maintains the channel 

* directory database (analogous to session directory -Sdr) . 
V 

private volatile Thread directoryThread - null; 
/** 

* This thread announces the channel descriptions to the local listeners. 
*/ 

private volatile Thread announcerThread • null; 
/** 

* This thread ia started along with the <code>directoryThread</code> . It is 

* used to generate the advertisement schedule. 
*/ 

private volatile Thread advert iseThread -null; 
/** 

* RAS channel registry / database. 
*/ 

private Channel [J channel Registry - null; 
/** 

* Station multicast address (CDP) to channel ID mapping. 
*/ 

private Hashtable channelMapper « null; 

private final static Integer NONSUPPORTED - new Integer (-1); 
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* Channel Announcement Protocol Cache. 
V 

private Hashtable capCache - null; 

* The RTSPServer remote controller. 
*/ 

private RTSPServerControl rtspServer = null; 
/" 

* The local multicast address dispenser (one instance per RAS) . 
•/ 

private MaddrDispenser l_maddrRegistry =» null; 
/** 

* The local multicast address for local station's content. 
V 

private InetAddress l_maddr_local - null; 
/*• 

* The local station's channel id. 
*/ 

public final static String LOCAL STA - "LOCAL" ; 
/** 

* The files containing local station's program announcement. 
*/ 

private final static String LOCALSTA_CDP - localcdp* ; 
private final static String LOCAL STA_5CHED - "_localsched - ; 

/** 

* Time interval between each Marconi process (30 seconds) . 
*/ 

private. final static long INTERVAL - 10000; // reduced for demo 
/** 

* Channel Announcement Protocol (CAP) resources. 
*/ 

private MulticastSocket cap_receiver — null; 
private MulticastSocket cap_sender - null; 
private boolean SOCKET 1_IN_USE - false; 
private boolean SOCKET2_IN_USE - false; 

/** 

* The RSA public key* 
*/ 

private byte M publicKey - ((byte) 0x0 >; 
/** 

* The RSA private key. 
*/ 

private byte [ 1 privateKey - {(byte) 0x0); 



* Instantiate the MarconiServer of RAS (radio antenna server) with its 

* default settings. It also establishes a connection to the RTSPServer. 



public MarconiServer (String rtsp_h, int rtsp_p) throws RemoteExcept ion { 
try ( 

// initialzie 

hostname * InetAddress .get Local Host O .get Host Name () ; 
rtspServer - new RTSPServerControl (rtsp_h, rtsp_p) ; 
channelRegistry - new Channel [MAX-CHANNELS) ; 



/** 
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channelMa* r = new HashtableO; 
capCache « ne w HashtableO; 
cap.sender - new MulticastSocket ( ) ; 
cap.receiver » new MulticastSocket (CAP _PORT) ; 
l_maddr Regi atry - new MaddrDispenser ( ) ; 
l_maddr_local » i_ maddrRegistry . next ( ) ; 

// join CAP multicast group 

cap_receiver. joinGroup ( Inet Address . getByName (GLOBAL_CAP) ); 

} 

catch (Exception e) { 

) 

start ( ) ; 

> 

/** 

* Registers a station into a channel slot. These slots are indexed through 

* the channel id's. 

* Gparam c the channel id. 

* Gparam ma global multicast address used for station broadcast. 

* Greturn true if the station/channel is successfully registered and false 

* otherwise. 
*/ 

public synchronized boolean registerChannel ( int c, String ma) 
throws RemoteExcept ion { 

// if channel is not already taken and its updated cache exists 
if (channelRegistry [cj null &6 capCache . containsKey (ma) > ( 

// add new channel to database , e , 
channelMapper .put (ma, new Integer (c)); 
try { 

TnetAddress l_maddr - l_.maddrRegistry.next <) ; 
channelRegistry [c] - new Channel (c, l_maddr) ; 

) 

catch (Maddr Except ion e) { 
return false; 

) 

// initialize channel from the cache 

channelRegistry [c] . read_.cdp( (CDPPacket) capCache. get (ma) ) ; 
channelRegistry [c] . init (publicKey, privateKey) ; 

// remove new channel from the global cache 
//capCache . remove (ma) ; 

System, out .print In 

(obj_narae + •.registerChannel: created channel-* ♦ c) ; 

return true; 

) 

// if channel in use 

else ( 

System, err .print In (obj_name + 

• .register .Channel : cannot create channel-* ♦ c) ? 

return false; 

> 

> 

* Removes a channel from the database. 
* 

* @param c the channel id to be removed. 
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* ©return true if the atatioh/channel is successfully 

* otherwise - 

public synchronized boolean removeChannel (int c) 
throws RemoteException ( 
// if the channel exists 
if (channelRegistry [c] != null) { 

// step the channel thread and free resource 
li (channelRegistry [c) . isOnline () ) { 
channel Registry (c] . destroy ( ) ; 

I 

l_madcrReg* st ry . remove (channelRegistry (cl . l_maddr) ; 
// r «(iove channel from database 

channe *Kapp«* • put t channelRegistry [c] ,g_maddr . getHost Address ( ) , 

NONSUPPORTED) ; 
chanrelRegtstry (c) - null; 

System out .print In (ybj_ name + ".removeChannel: removed channel-" ♦ c) ; 
returr. tfu«; 

> 

// if the mannei do«an*t exist 

else { 

System, met .println <obj_name + 

• . remove , Channel : cannot remove channel-" ♦ c) ; 

return false; 

> 

) 

r * 

/* 

* (Sdeprecated replace by R7CP signaling. 

* This class does rot actually implement the audio playing mechanism. It 

* Return the status cf this request. This method is merely used as means 

* of finding out who's listening to what. The next version should replace 

* this module with a more scalable approach such as by utilizing the 

* RTCP signals. Currently, this RMI request is also being used to trigger 

* the actual broadcasting. If the requested channel is broadcasting 

* already, nothing else is done, if not, the MarconiServer initiates the 

* broadcasting procedures (i.e. start listening to the global multicast 

* address and redirecting the stream locally). 
★ 

* Gparam c the channel id. 

* Creturn true if successful, false otherwise. 
* 

public synchronized boolean playChannel (int c) 
throws RemoteException { 

// if channel em 1st a 

if (channelRegi»trylc) !- null) < 

// if channel not already started, signal RTSPServer to start it 
channelRegistry Cc] .HIT_C0UNT*m*; 
if ( (channelRegistry (c) .isOnline () ) { 
try { 

channelRegistry (c) . start O ? 

System. out . print In (obj_name + ".playChannel: channel-" ♦ c 
+ • started."); 

) 

// catch TooKanyChannelThreadsException 
// & lllegalThreadStateException 
catch (Exception e) 4 

System. err .print In (obj_name + 
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} 

i 

// return the local multicast address of the channel 
return true; 

) 

else { 

System. err .print In <obj_name + 

■ .playChannel : cannot play channel-" + c) ; 

return false; 

> 

) 

*/ 
/** 

* Stops all broadcasting channels and terminates this RAS . 
*/ 

public void shutdown () throws Remote Except ion { 
synchronized (channelRegistry) { 

for (int i = 0; i < MAX_CHANNELS ; i++> ( 
if (channelRegistry [i] !» null) { 
rernoveChannel (i) ; 

} 

> 

} 

stopO; 

System-exit (0) ; 



/** 

* Starts the MarconiServer . 
*/ 

public void start {) { 

directoryThread - new Thread (this) ; 
directoryThread. start < ) ; 
announcerThread - new Thread (this).; 
announcerThread. start () ; 
advertiseThread » new Thread (this) ; 
advert iseThread. start () ; 



/** 

* Stops the MarconiServer. 
*/ 

public void stopO { 

directoryThread • null; 
announcerThread — null; 
advertiseThread — null; 

// release sockets and leave announcement group 
try { 

while ( SOCKET 1_IN__ USE ) { 
Thread . sleep < 3 > ; 

> 

cap_receiver . leaveGroup ( XnetAddress . gecByName (GLOBAI^CAP ) ) ; 
cap_recei ver . close ( ) ; 
cap.sender . close ( ) ; 

) 

catch (Exception e) { 

e . print St ackTrace ( ) ; 

J 

> 
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• .playChannel : 



return false; 
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/ 



Returns the channel usage statistics. 



Qretum an array of channel statistics. The array size is the 

< code >MAX_CHANNELS</ code > . There maybe <code>null<:/code> entries in the 
array for the channel slots that are not supported. 

*/ 

public ChannelStatisticsC] getStatist ics ( ) { 

ChannelStatistics [ ] stats » new Channel St at ist ics [MAX_CHANNELS] ; 
synchronized (channelRegistry) ( 

for (int i = 0; i < MAX_CHANNELS ; i++) < 
if (channel Registry [i J ! - null) ( 

stats [i] = channelRegistry ( i ]. audit () ; 

\ 

) 

) 

return stats; 

> 

* Adds commercial list. 

* Gparam ad_list an array of <code>String</code>s that refers to the 

* commercial filenames. 

* ©return whether the request was successful. 
*/ 

public boolean submitCommercialList ( String [ ) ad_list) { 
try { 

for (int i - 0; i < ad_ list . length; i++) < , 
StringTokenizer st - new StringTokenizer (ad_list [i] ) ; 
int id • Integer .parselnt (st .nextToken 0 ) ; 
channelRegistry [id] .addConunercial (st .next Token () ) ; 

> 

for (int i = 0; i < MAX^CHANNELS ; i++) ( 
if (channelRegistry (i] i- null) { 

channelRegistry [ i ] . genCommercialFile ( ) ; 

> 

> 

return true? 

> 

catch (Exception e) { 

Sy stem. err .println (obj_ name + 

• .subraitCommercialList : illegal list format"); 

return false; 

} 

} 

/* 

* This <code>run</co4©> method starts the Marconi Server . 
*/ 

public void runO { 

// cache update hour 

long hour - System, cur rent TimeMi 11 is () ; 
/* 

* Global directory thread running. 

while (Thread. currentThxeadO — direct oryThread) ( 
/* 

* Receive CDP packets and maintain channel database. 
*/ 
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SOCKET 1_IN_USE - true; 
try < 

DatagramPacket recvjilct *» CDPPacket .compose () ; 
cap_receiver .receive (recv_pkt) ; 
CDPPacket cdp = new CDPPacJcet <recv_pkt ) ; 

synchronized ( channelRegist ry) ( 

// create new mapping 

if < ! channelMapper .containsKey (cdp.MADDR) ) { 

channelMapper .put (cdp.MADDR, NONSUPPORTED) ; 

) 



// update announcement appropriately 

Integer Id = (Integer) channelMapper .get (cdp.MADDR) ; 
if ( Id* equals <NOT_SUP PORTED) ) { 
capCache . put (cdp.MADDR, cdp); 
System, out .pr^nt lr. (obj^name * ".run: new cdp cached for " +■ cdp.MADDR); 

\ 

• la* ( 

cnannelRegistry ( Id.intvalue <) ] . read_cdp (cdp) ; 
System. out .pr ; nt ir tcDj^nasw * ".run: local channel's cdp cache refreshed"); 

} 

cat ztt tictpticn • ) ( 

•pcintSt ackTrace () ; 

) 

30C»XT:_:h_U3C - false; 

// tiM to ref tesh cache (daily) 
lorvj Ckjrrent_i%cur - System . currentTimeMil lis () ; 
if iciirr«nt_haur > hour + Times tamp. DAY) { 
System. out .print In too ).nAn ♦ ".run: routine -refresh local cache"); 

c«f r«»h_cach* () ; 

hour T Me a tamp. DAY; 

/• 

* Interval b/w each loop for receiving global channel directory. 
•/ 

if <! Thread, interrupted () ) { 
try i 

System, out .print In (ob j_na/»e ".run: - "); 

Thread. sleep (INTERVAL) ; 

) 

catch ( Interrupt edExcept ion e) { 
} 

) 

> 

/* 

* Local Directory thread running. 
*/ 

while (Thread .currentThread <) announcerThread) { 
/* 

* For each installed local channel send out announcements. 
V 

for <int i - 0; t < MAX_CHANNELS && announcerThread I- null; i++) i 
it (channel Registry (i) «- null) { 
continue; 

) 
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CDPPacket lo^a_cdp - channelRegistry [ i] .writ 

DatagramPacket send_pkt - local_cdp .compose ( LOCAL__CAF , CAP_PORT) ; 
try i 

cap.sender . send (send_pkt , (byte) LOCAL.TTL) ; 

) 

catch (lOException e) ( 

System. out .println (ob j_name * * . run : "); 
e.printStackTrace () ; 

) 

// sleep between every announcement (do not flood network) 

try { 

Thread. sleep(5000) ; 

) 

catch ( InterruptedException e) ( 

) 

/* 

* Announce local track programming. 
*/ 

if (announcerThread !« null) { 
try i 

CDPPacket localsta_cdp - write_cdp<) ; 

DatagramPacket send_pkt - localsta.cdp. compose (LOCAl_CAP, CAP_PORT) ; 
cap_sender.send(send_pkt, (byte) LOCAL_TTL) ; 

^ 

catch (Exception e) ( 

System, out .println (obj__name ♦ ".run: •) ; 

e.printStackTrace () ; , r 

\ 
) 

/* 

* Interval b/w each loop for sending local channel directory. 
V 

if (! Thread. inter ruptedO ) { 
try { 

Thread, sleep (INTERVAL) ; 

catch (InterruptedException e) { 
} 

) 

> 

/* 

* Advertise thread running. 
*/ 

while (Thread. currentThreadO — advert iseThread) ( 

**Dump each channel's commercial queue (list of commercials to play* 

* to a file so that it can be used by the IAIP (local advertisement 

* insertion protocol) . 
*/ 

for (int i - 0; i < MAX-CHANNELS; i*+) < 
if (channelRegistry [i] 5- null) i 

channelRegistry [il .genComraercialFile () ; 

> 

} 

/* 

* Interval b/w each loop for generating commercial files. 
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if (! Thread. interrupted () ) { 
try { 

Thread. a ieep (Timest amp. DAY / 4); 

} 

catch ( Interrupt edExcept ion e) { 
} 

) 

//Thread.yieldt) ; 

) 

) 

/ • - 

* Removes old cache entries. 
•/ 

private void ref resh_cache ( ) { 

long current_hour » System . currentTimeMillis () ; 

synchronized (capCache) { 

Enumeration capList =• capCache . elements () ; 
while (capList . hasMoreElement s ( ) ) { 

CDPPacket cdp » (CDPPacket) capList . nextElement () ; 
if <current_hour > cdp . time 5 tamp + CDPPacket . TTL) ( 
capCache. remove (cdp. MADDR) ; 

) 

I 

) 

) 

/** • 

* Provides local and global cache of channel announcements for : 

* immediate download (instead of waiting for the periodic announcement) . ' 

* Q par art local <code>true</code> if requesting for a local announcement download. 

* Greturn list of channel descriptions (CDPPackets) in <code>Vector</code> . 

* Gsee marconi.util .CDPPacket 
•/ 

public vector downloadCAP (boolean local) throws RemoteException ( 

// return local announcements 
if (local) ( 

synchronized (channelRegistry > ( 

Vector cdp_ list — new Vector () ; 

for (int i - 0; i < MAX_CHANNELS; i++) < 
if (channelRegistry [ i] !» null) { 

CDPPacket cdp - channelRegistry [i ) .write_cdp O ; 
cdp_liat .addElement (cdp) ; 

) 

) 

return cdp_list; 

) 

> 

// return global announcements 
else ( 

synchronized (capCache) { 

Vector vec - new Vector (); 

Enumeration enura - capCache .elements <) ; 

while ( enura. hasMoreE lements () ) ( 

vec . addElement ( enum . nextElement ( ) ) ; 

> 

return vec; 

} 

} 



i 
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* Creates a CDP announcement for the local station track. 

* ^return a channel description of the local track. 

* (?see marconi . util .CDPPacJcet 

private CDPPacJcet write_cdp() throws AnnouncementException { 
CDPPacket cdp - null; 
Buf feredReader fin « null; 
String schedule « *"; 

try i 

cdp = new CDPPacket (LOCALS TA_CDP) ; 

fin * new Buf f eredReader (new FileReader <LOCALSTA_SCH£D) ) ; 

\ 

catch (Exception e) < 

throw new AnnouncementException 

(obj_ name + * . write_cdp : the local schedule file cannot be opened."); 

) 

while (fin !» null) { 
String line 53 null; 
try ( 

if ((line - fin.readLine () ) ™ null) { 
fin . close ( ) ; 
break; 

) 

) 

catch {IOException e) { ,* 
break; < r 

> 

if (line. length () > 0) < 
String program ■ "•; 

StringTokenixer st « new StringTokenizer ( line) ; 
Calendar cal - Calendar .get Instance () ; 

try { 

for (int i - 0; i < 2; < 

cal . set (Calendar . DAY_OF_WEEK, Integer. parselnt {st .nextToken () ) ) ; 
cal. set (Calendar. HOUR w _OF_DAY, Integer .par selnt (st .nextToken ( ) ) ) ; 
cal .set (Calendar .MINUTE, Integer .parselnt (st .nextToken <) ) ) ; 
cal . set (Calendar . SECOND, integer .parselnt (st .nextToken () ) ) ; 
program +- String .valueOf (cal . getTime () .getTime () ) + 

) 

program st . nextToken ( ) + 

schedule (schedule. length () >0) ?",":""+ program? 

> 

catch (Exception e) { 

throw new AnnouncementException 

<obj_naiue ♦ ".write.- cdp: invalid local schedule file."); 

) 

) 

> 

cdp. id - LOCALSTAf 

cdp. date » Timestarap.get_roidnight () ; 

cdp .MAD DR «• this . ljnaddr_loc a l.get Host Address {) ; 

cdp.MPORT - this.IRC^PORT; 

cdp.MTTL - this.LOCAIwTTL; 

cdp. schedule - schedule; 



return cdp; 
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* The main method executes the server setup proce... 
*/ 

public static void main (St ring args U ) throws RemoteException { 

// check arguments (rtsp server) 
if (args. length !- 2) { 

System-err. println ( "usage : \n* 

+ "MarconiServer <RTSP hostname> <RTSP port>"); 

System. exit (-1) ; 

> 

System. setErr (System. out) ; 

// install a security manager 

System. setSecurityManager (new RMISecurityManager ( ) ) ; 

// setup and start the server on local host 
try ( 

LocateRegistry .createRegistry (RMI_PORT> ; 

MarconiServer marconiServer ■» new MarconiServer (args (0] , 

Integer .parse Int (args [1] ) ) 
Naming. rebind(V/ : " + RMI_PORT + V" + obj_name, marconiServer); 
System. out .println (marconiServer . hostname 

+ " bound in registry at port " +- RMI_PORT) ; 

) 

catch (Exception e) i 

System.err .println (obj_name t- ".main: " + e .getMessage ( ) ) ; 
e. print St ack Trace <) ; 

} 

) 
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/* marconiNet - internet Radio Network 
* Distributed Radio Antenna Server (RAS ) : t IRC GUI Controls) 



ni.irOlRCControls.java -v2 . 0 (prototype version), 1999/02/15 S 



package marconi.irc; 

import java.awt.*; 
import java . awt .event . *; 
import java.util.*; 
import java.net.*; 
import java.io.*; 



* This panel contains user interfaces to the applet. 



public class IRCControls extends Panel { 
public static TextField entry. 1; 
private static int WIDTH - 600; 
private static int HEIGHT - 100; 

/** 

* instantiates the control panel. 
V 

public IRCControls () i 

GridBagLayout grid «■ new GridBagLayout ( ) ; 
GridBagConstraints cons - new GridBagConstraints () ; 
setLayout (grid) ; 

cons. fill - GridBagConstraints . NONE; 
cons.weightx - 0.0; 



// selected station (id + name) 

entry_ 1 - new TextField (40 ) ; 

grid.setConstraints <entry_l, cons) ; 

entry_l .set Foreground (Color .yellow. dar Jeer ( ) ) ; 

entry_l .setBackground (Color .blue. darker () .darker <) ) ; 

add(entry_l) ; 

validate (); 

// resize 

setSize (WIDTH, HEIGHT) ; 



* Gjdkl.2, -riK. 
V 



> 



} 
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/* marconiNet - Internet RadTo Network 

* Distributed Radio Antenna Server (RAS) : [IRC Directory Controls) 
* 

* $<marconi. ras . >IRCDirectory . java -v2 . 0 (prototype version), 1999/04/20 $ 

* Qjdkl.2, ~riK. 
V 

package marconi. ire; 

import j ava . awt . * ; 

import java. awt . event - *; 

import java . util . Has ht able; 

import java.net . *; 

import java. io . *; 

import marconi . ras , MarconiServer; 

import marconi . util . CDPPacket; 



* This panel contains user interfaces to the applet. 
•/ 

public class IRCDirectory extends Panel 
implements Runnable { 

/*• 

* This thread updates the announcements for the locally supported channels. 
*/ 

private Thread updateThread — null; 
private static long L_UPDATE - 7500; 

public static IRCUsrApplet owner; 
public static Label label_l; 
public static List directoryList_l; 
private static int WIDTH - 600; 
private static int HEIGHT - 400; 

/•* 

* Instantiates the directory display panel. 
*/ 

public IRCDirectory (IRCUsrApplet main) ( 
owner *» main; 

GridBagLayout grid • new GridBagLayout {) ; 
GridBagConstraints cons - new GridBagConstraints () ; 
setLayout (grid) ; 

cons, fill - GridBagConstraints .NONE; 
cons . weightx *» 1.0; 



// label 1 

cons. weightx » 1.0; 

cons . gridwidth • GridBagConstraints .REMAINDER; 
label_l - new Label ( ) ; 

label_l.setText ("Local Channel Directory"); 
grid . set Const raint s ( label_l # cons ) ; 
label.l . aetForeground (Color .white) ; 
add(label_l); 
validate () ; 

// list 1 - global 

cons* gridwidth - GridBagConstraints .REMAINDER; 
directoryList_l - new List (20, false); 

directoryList_ 1 . addAct ionListener ( IRCAct ionHandler . listControl) ; 

grid. setConstraints (directory List_l, cons) ; 

directoryList_l .setForeground (Color. yellow, brighter () ) ; 

direct oryList_ 1 . setBackground (Color .darkGray) ; 

add (direct oryLi st _1) ; 

validate () ; 
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// reside 

aetSize (WIDTH, HEIGHT); 
start ( ) ; 

) 

/** 

* Starts the directory update. 
•/ 

public void start () { 

updateThread = new Thread (this) ; 
updateThread. start () ; 

} 

/** 

* The run methods for the two threads. 
*/ 

public void run ( ) { 

// local directory 

while (Thread. currentThread ( ) ™ updateThread) < 
try { 

Thread. sleep <L__update> ; 

Haahtable cdp_loolcup - owner .getCache () ; 

if (directoryList_l .get ItemCount {) > 0) ( 
directory List — 1 . reraoveAll ( > ; 

} 

for (int i « 0; i < owner. MAX_CHANNELS? i+*-> { & , 

String id =» String. valueOf (i) ; , 
if (cdp_lookup.containsKey (Id) ) ( ! 
CDPPacJcet cdp - (CDPPacket) cdp_lookup.get (Id) ; 
directory List_l .add (cdp. id ♦ ■■ • ♦ cdp. name, 

Integer. par solnt (cdp. id) ) ; 

> 

else { 

directory List_l , add < Id) ; 

> 

} 

if (cdp_lookup. cont a ins Key (Marconi Server . LOCALSTA) ) ( 

CDPPacket cdp - (CDPPacket) cdp_lookup. get (Marconi Server . LOCAI*STA) 
directory List_ 1 . add ( cdp . name ) ; 

) 

} 

catch (Exception e) { 

System. err .println ("marconi .ire. IRCDirectory . run: ■) ; 
e .printStackTrace < ) ; 

} 

> 

> 

} 
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/* marconiNet - mternet Racffo Network 

* Distributed Radio Antenna Server (RAS) : (IRC User Applet] 

* $<rnarconi.irc>IRCUsrApplet. java -v2 . 0 {prototype version), 1999/04/20 $ 

* @jdkl.2, -riK. 
*/ 

package marconi . ire; 

import java . applet . *; 

import java . awt . * ; 

import java.util.*; 

import java . net . * ; 

//import java. rmi . * ; 

//import java. rmi . server . * ; 

import marconi .utiL . *; 

import marconi .util . rtsp . IRC; 

import marconi . ras . RAS; 

import marconi . ras .MarconiServer; 

* This applet is used by an IRC user. 

* Gauthor ~riK. 

* Qversion $Revision: 1.0 5 

* @see marconi . ras . MarconiServer 

* Qsince prototype vl . 0 
V 

public class iRCUsrApplet extends Applet 

implements java. io - Serial izabie, Runnable { * 

/** 

* Session Announcement Protocol (SAP) resources. 

* Interfaced via. Channel Directory/Description Protocol (COP) . 
*/ 

private Multicast Socket cap_ receiver — null; 
protected Has ht able capCache - null; 

/** 

* This thread updates the announcements for the locally supported channels. 
V 

private Thread directoryThread - null; 
private static long L_UPDATE - 10000; 

// miscellaneous variables 
private static int width - 0; 
private static int height - 0; 
//protected RAS ras Server - null; 
protected int MAX_CHANNELS - 20; 

final static String ob j_nane - " mar coni.r as. IRCUsr Applet"; 



// tools 

IRCDi rectory directory - null; 
IRCControls controls — null; 
IRC listener - null; 

/** 

* Initialize the applet and setup display area. 
*/ 

public void initO ( 
try i 

width - Integer, parselnt ( get Parameter { "APPLWIDTH* ) ) ; 
height » Integer .parse Int < get Parameter ("APPLHEIGHT") ) / 

// lookup RAS (MarconiServer) 
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//UR1* UTU-base - getDocumentBase ( ) ; 

//System, out .print In <obj_nanie + ".init: locating server*); 
//raaServer - (RAS) Naming . lookup ("// • + get Parameter ( "RASHost " ) 
// + - : • + getParameter ( *RASPort • > 

// * " /marconi . ras -MarconiServer • ) ; 

// init variables 

/ /MAX— CHANNELS - raaServer . getMaxChannels ( ) ; 
capCache - new HashtableO; 

) 

catch (Exception e) { 
// fatal error 

System. err .println (ob j_name + ".init: " ) ; 
c. print St ackT race () ; 

) 

// loir. CAP multicast group 
try i 

cap.raceiver • new MulticastSocket (MarconiServer .CAP__PORT) ; 
cip.r#c«iv«r . joinGroup < I net Address .get ByName (MarconiServer .LOCAL__CAP) ) ; 

> 

catch <t«c*ptioa a) 4 

5 /it . out . pr int In (ob j_name +■ ".init:"); 
t.prmt St id Trace ( ) ; 

) 



// draw display araa 
set upOisp: ay < » ; 



// start 

listener • :ftCU; 
directoryThraad • raw Thread (this) ; 
director yThraad . start ( I ; 

> 

/** 

* Display the applet. 
*/ 

public void aatupOi splay ( ) ( 

set Background (Color .black) ; 



directory - naw XRCDirectory (this) ; 
controls • nmm IRCControls ( ) ; 
GridBagLayout grid - new GridBagLayout ( ) ; 
GridBagConst ramt a cons - new GridBagConst raints () ; 

// setup grid 

int rovHelghtsU • (400, 100 >; 
grid.rowBelghta - rowHeights; 
set Layout (grid) ; 

cons. fill ~ GridBagConst raints . BOTH; 
// add directory lists 

cons .gridwidth - GridBagConst raints .REMAINDER; 
cons. weight* - l.C; 
cons .gndheight - 1; 

grid.setConstrai.nts (directory, cons) ; 
add (directory) ; 
validate () ; 

// add controls 

cons.gridwidth - GridBagConst raints .REMAINDER; 
cons. weight x - 1.0; 
cons.gridheight - 1; 
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grid.aetConstraints {controls, cons) ; 
add (controls) ; 
validate () ; 

resize (width, height); 

/*♦ 

* Free resources when closing applet. 
*/ 

public void destroy () ( 

// release sockets and leave announcement group 
try { 

cap_receiver . leaveGroup ( InetAddress . getByName (MarconiServer . LOCAl,_CAP) ) ; 
cap_receiver . close () ; 

) 

catch (Exception e) { 

e . printStackTrace ( ) ; 

} 

stopChannel {) ; 
directoryThread - null; 

//try { 

// rasServer . terminate () ; 
//) 

//catch (RemoteException e) { 
// e. printStackTrace () ; 
//> 

remove (directory) ; g , 

remove (controls) ; 

> 

/** 

* Run method. 
*/ 

public void runO { 

// cache update hour 

long hour » System. currentTimeMillis () ; 
/* 

* Global directory thread running. 
V 

while {Thread . cur rent Thread () — directoryThread) { 

i 

/* 

* Receive CDP packets and maintain channel database. 
*/ 

try { 

DatagramPacket recv_ pkt «■ CDFPacket .compose () ; 
cap^receiver . receive ( recv_pkt ) ; 

CDPPacket cdp - new CDPPacket (recv_pkt) ; 

System, out .print In (ob j_name + w .run: cdp parsed*); 

// update announcement appropriately 
if ( ! capCache . containsKey (cdp . id) ) { 
capCache.put (cdp.id, cdp); 

System. out .print In (obj_name + ".run: new cdp cached for channel-" 
+ cdp.id) ; 

) 

) 

catch (exception e) { 
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e . printStackTrace ( ) ; 

) 

// time to refresh cache (daily) 

long current^hour » System . currentTimeMillis () ; 

if (current^hour > hour + Time stamp . DAY) ( 

System, out*, print In <obj_nartie + ".run: routine -refreshing directory cache."); 

refresh_cache () ; 

hour +■ Timestamp.DAY; 

) 

/• 

* Interval b/w each loop for receiving local channel directory. 
•/ 

try { 

Thread. sleep (L_UPDATE) ; 

) 

catch ( InterruptedException e) { 
) 

) 

) 

• Penoves old cache entries. 
•/ 

protected void ref resh_cache < ) { 

long current_hour - System. currentTimeMillis () ; 

synchronized (capCache) { ,* 
Enumeration capList =» capCache . elements () ; , # 

while (capList . hasMoreElements () ) { 

CDPPacket cdp - (CDPPacket) capList . next Element () ; 
if <current_hour > cdp.timeStamp + CDPPacket .TTL) < 
capCache . remove (cdp. id) j 

> 

> 

) 



/*• 

* Inform server that the specified channel is being listen to. This 

* RMI based triggering is very inefficient and not scalable. So 

* alternate approach based on RTCP should replace this. 
*/ 

public boolean pi ay Channel (int id) { 
boolean status — false; 

if (capCache. containsKey (String. valueOf (id) ) ) ( 

CDPPacket cdp - (CDPPacket) capCache .get (String. valueOf (id) ) ; 
try < 

// kill previous thread if running 

listener . stop ( ) ; 

/• 

* The below statement is commented out because the listener 

* is now capable of sending RTCP signals for triggering. 
* 

status - ras Server .playChannel (id) ; 
*/ 

status - true; // replace above 
listener, start (cdp.MADDR, cdp.MPORT); 

> 

catch (Exception e) i 

e .print StackTracei) ; 
return false ; 
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return status; 



else { 



return false; 



* Stops listening to whatever is playing. 
*/ 

public void stopChannel ( ) { 
listener . stop ( ) ; 

) 

/** 

* Returns the current state of the local channel announcement cache. 
V 

protected synchronized Hashtable getCache O < 
return capCache; 

) 

/** 

* Return applet information. 
*/ 

public String getAppletlnf o ( ) { 
return "IRC listener tool"; 

} 



} 
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/* marconiNet - Internet Radio Network 

* Distributed Radio Antenna Server (RAS) : [IRC Action Handler 1 
* 

* S<marconi. ire .> IRCActionHandler . java -v2 . 0 (prototype version), 1999/04/21 S 

* @jdkl-2, -riK. 

package marconi.irc; 

import java.awt.*; 
import java.awt .event . *; 
import java.util.*; 
import java.io.*; 

/** 

* This class handles actions taken by IRC user. 
V 

public class IRCActionHandler { 

public static Act ionListener listControl =» new ActionListener ( ) { 
public void act ionPerf ormed (ActionEvent e) { 
IRCControls.entry._l .setText 

( IRCDirectory ,directoryList__ 1 .get Item 
( I RCDi rectory .di rectory Lis t__ 1 . get Select edlndex () ) ) ; 
String textfield = IRCControls - entry_l . gettext ( ) ; 
StringTokenizer dir - new StringTokenizer (textfield, " *); 
int id » Integer . parselnt (dir . nextToken () ) ; 
if ( IRCDirectory . owner .playChannel (id) ) ( 

System. out . print In < "marconi . ire . IRCActionHandler' ♦ 

actionPerf ormed: playing channel " 
+ id + ■ . " ) ; # * 

> a 

else ( 

IRCDirectory. owner .stopChannel () ; 

System. err .print In ("marconi . ire. IRCActionHandler" + 

". actionPerf ormed: error listening."); 

> 
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/* marconiNet - Internet Radio Network 

* Distributed Radio Antenna Server <RAS) : [CDP Announcer] 
* 

* $<marconi . ras . >Announcer . java -v2 . 0 (prototype version), 1999/04/12 $ 

* <?jdkl.2, -riK. 
•/ 

package marconi.rsc; 

import java-net.*; 
import }ava . util.*; 
import java . 10 . 

import marconi . cas . Marconi Server; 
import marconi . Jtil . *; 

/•• 

* The <code>Announcer</code> makes periodic announcements via. CDP (SAP/SDP) . 

* <p> 

* ^author -r:X. 

* @v«rsion SRevision: 1.0 $ 

* (?s*e rear rem . uti 1 -CDPPacket 

* 6smce prototype 1.0 
•/ 

public class Announcer implements Runnable { 

final static String ob]_name d "marconi . rsc .Announcer" ; 
String hostname - 

/•• 

* This thread announces the channel descriptions to the local listeners. 

*/ 

private volatile Thread announcerThread — null; f , 

/•• 

* Time interval between each Marconi process (30 seconds) . 
•/ 

private final static long INTERVAL » 30000; 
/** 

* Channel Announcement Protocol (CAP) resources. 
*/ 

private Mult icastSocket cap_sender - null; 

private String file « "•; 

/** 

* Constructor. 
*/ 

public Announcer (String file) \ 
try { 

hostname - I net Address .getLocalHost t ) .getHostNarae ( ) ; 
cap_sender — new MulticastSocket ( ) ; 

> 

catch (Exception e) { 
) 

this. file - file; 
start (>; 

> 

/•* 

* Starts the Announcer. 
•/ 

public void start <) ( 

announcerThread - new Thread (this ) ; 
announcerThread. start () ; 

> 
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/** 

* Stops the Announcer. 
*/ 

public void stopO { 

announcerThread - null; 

// release sockets and leave announcement group 
try { 

cap_sender. close <) ; 

} 

catch (Exception e) { 

e .print St ackTr ace < ) ; 

> 

) 

/*• 

* This <code>run</code> method starts the Announcer* 
*/ 

public void run() { 
/* 

* Announcer thread running. 
*/ 

while ( Thread. currentThread () ™ announcerThread) { 
/* 

* Send out each announcement. 
*/ 

CDPPacket cdp - null; , : 

try { 

cdp =* new CDPPacket <f ile) ; 

} 

catch (AnnouncementException e) { 
e . printStackTrace ( ) ; 

} 

DatagramPacket send_pkt =» cdp • compose ( Marconi Serve r . GLOBAL_CAP , 

MarconiServer .CAP_PORT) ; 

if (cdp. id !=» null) < 
try { 

cap_sender.send<sendLpkt, (byte) MarconiServer .GLOBAI^TTL) ; 

) 

catch (IOException e) { 

System, out .print In (obj^name ♦ ".run; 
e .printStackTrace ( ) ; 

> 

System, out .print In (obj_ name ♦ ".run: announcement sent to • 
+ MarconiServer . GLOBAI^CAP + ■/■ 
+ MarconiServer .CAP^PORT) ; 

> 

/* 

# Interval b/w each loop for sending local channel directory. 
*/ 

try < 

Thread . s leep ( INTERVAL) ; 

) 

catch ( Inter ruptedExcept ion el i 
> 

} 

} 
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./* 

* The main method executes the server setup process. 
*/ 

public static void main (String args [ ] ) { 
// checlc arguments (rtsp server) 
if (args. length !=• l) { 

System .err .println ("usage: \n" + "Announcer <CDP file>*); 

System. exit <1) ; 

) 

System. setErr (System. out ) ; 

// Setup and start the server on local host 
Announcer announcer = new Announcer (args [0 ]) ; 



* 



* 

t - 
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/* marconiNet - internet Radio Network 

* Distributed Radio Antenna Server (RAS) : [RSC Interface] 
* 

* 5<marconi .ras.>RSC. java -v2 . 0 (prototype version), 1999/05/14 5 

* A-iHVi . ? . -riK - 



(Jjdkl.2, -riK. 
*/ 

package rnarconi . rsc; 

import java . rmi . * ; 
import java .util .Vector; 



* The <code>RSC</code> RMI interface provides security/payment APIs for RAS. 

* <p> 



* Gauthor -riK. 

* Aversion SRevision: 1.0 $ 

* Gsince prototype vl.O 
*/ 

public interface RSC extends Remote { 



* Accept RA$' public key and include thi3 RAS for SEK distribution. 

* $enroll (byte [ ] publicKey) $ 



public int enroll <byte [ ] pubkey) 
throws RemoteException; 

\ 
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/* raarconiNe: - Internet Radio Network 

* Distributed Radio Antenna Server <RA5> : [Channel Descriptions Class) 
* 

* S<marconi.ras.>CDPPacJcet. java -v4 . 0 (prototype version) , 1999/05/05 $ 

* Gjdkl.2, -riK. 
♦/ 

package marconi .util; 

import java.io.*; 

import java.net.*; 

import java . util . StringTokenizer ; 

import marconi .util . sd. * ; 

/** 

* This class encapsulates and parses the Channel Description Protocol (CDP) 

* Packet. It acts as an transparent interface to the SAP/SDP protocol (the 

* utilization of protocols SAP/SDP is hidden from the users of CDP) . 

* <p> 

* Included in the packet are a subset of the following fields in any order: 

* <ul> 

* <li>name 

* <li>category 

* <li>description 

* <li>origin 

* <li>language 

* <li>id 

* <li>maddr 

* <li>mport 

* <li>mttl 

* <li>seklist 

* <li>date* 

* <li>schedule* 

* </ul> 

* <p> 

* The channel description can be created from a file or any other object that 

* can be converted to a text stream. The format is given below. 

* <p> 

* Each field is to be contained in a line. Each line is to start with the field 

* name followed by ' *' , and then the field value (i.e. "category-news"). 

* <p> 

* The fields marked * are optional if the CDP packet is not being used to announce 

* program schedules. If the CDP packet is used for program schedule announcement, 

* all the fields must be specified. (Note: the current version only allows one-day 

* scheduling per an announcement. Multiple CDP packets should be used to schedule 

* for different dates) There is no version number, nor is there a session id. A new 

* announcement can simply replace the previously received ones. The different 

* announcements are distinguished by examining the multicast address and the date. 

* if one wishes to schedule ahead of time, the date field should be used to indicate 

* to which date the schedule field is assigned. 

* <p> 

* The <code>schedule</code> field should be in the following format: 

* <pxblocJcquotexpre> 

* schedule-41t;prograral6gt; , &lt ;program2> * < program3> , . . .etc. 

* </pre></blockquote> 

* <p> 

* separating each sub-field with a comma <*,'). 

* <p> 

* The <code>date</code> field ia represented by specifying the number of 

* milliseconds since the standard base time known as "the epoch* , namely 

* January 1, 1970, 00:00:00 GMT. GMT (Greenwich Mean Time) is the Internet 

* conventional reference time zone and it is synchronized with the UTC 

* (Coordinated Universal Time) milliseconds. The receivers of this packet can 

* convert this to the appropriate local time. The data type long (64-bit integer 

* in Java) stores these milliseconds. Note that SDP uses the Network Time Protocol 
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* (NTP) timestarapa and SDP essentially converts UTC t. . 

* <P> 

* Each program is constructed as: 

* <pxblockquote><pre> 

* filt ; start-tiraeAgt; | 4 It ; end-tirae4gt ; I A It ; prograra-t it leigt ; I & It ; descr ipt ion&gt 

* </pre></blockquote> 

* <P> 

* separating each sub-field with a vertical line CI'). Again, UTC milliseconds 

* should be used to specify the times. 

* <p> 

* Lastly, the seklist is the concatenated list of the radio station's session 

* encryption key (SEK) , each time encrypted with the public key that belongs to 

* different RASs (if global announcement) or IRCs (if local announcement) . The 

* encrypted values in binary are PEM-encoded and the delimiter ' | r is used to 

* separate them. Currently CDPPacket is implemented to support RC4 stream cipher; 

* it is a symmetric encryption algorithm with variable key size and fast performance 

* in software. Another nice feature about it is that it is fairly exportable from US, 

* which is necessary for global usage of MaroniNet . 

* <p> 

* It is necessary that all fields be included (except for the optional ones) , although 

* it is not required to have them in order. 

* <p> 
* 

* Gauthor ~riK. 

* Aversion ^Revision: 1.0 $ 

* Gsee marconi . util . AnnouncementException 

* Ssee marconi .util . Time st amp 

* Gsince prototype vl.O 

*/ * * 

public class CDPPacket implements Serializable { * : 

final static String obj_ name - "marconi . ras .CDPPacket 

/** 

* The station name. 
*/ 

public String name - null; 
/** 

* The content category { music I news | sports I ... ). 
*/ 

public String category - null; 

* The content description. 
*/ 

public String description - null; 
/** 

* The origin of the content (regional ID) . 
*/ 

public String origin - null; 
/** 

* The language of choice. 
*/ 

public String language - null; 
/** 

* The multicast address. 
*/ 

public String MAODR - null; 
/** 

* The multicast port. 
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V 

public int MPORT - 8888; 
/** 

* The multicast ttl (set to local scope by default) * 
*/ 

public int MTTL -16; 
/** 

* The array of PEM-encoded (base64) session encryption keys. 
V 

public String(] SEKLIST = null; 
/** 

* The channel id. Must be the local hostname if used for global 

* announcement . 
*/ 

public String id = null; 
/** 

* The date being scheduled. 
*/ 

public long date » -1; 
/** 

* The radio station's content schedule (list of programs) 
*/ 

public String schedule — null; 
/** 

* The date and time of the packet created. 
*/ 

public long timeStamp - -1; 
/■** 

* The life time of CDP packets (expiration time) . 
*/ 

public final static long TTL - Time stamp. DAY; 
/** 

* The maximum CDP packet buffer length (currently 4K bytes) . 
*/ 

public final static int MAX_BUFLEN - 4 096; 
/** 

* Raw data containing, the byte-array representation of the packet, if it has 

* one ♦ 
*/ 

private byte(] data • null; 
/** 

* Creates an empty CDP packet. 
V 

public CDPPacketO ( 

this. timeStamp • Time at amp. get_cur rent () ; 

) 

/*• 

* Creates CDP packet from a (received) datagram. 
* 

* eparam packet the datagram packet that contains CDP. 
*/ 

public CDPPacket (DatagramPacket packet) throws Announcement Except ion ( 
parse (packet ) ; 
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this .times tamp « Timestamp . get_current ( ) ? 

) 

* Creates a CDP packet from a file. 
* 

* 9para« file pathname to where the CDP-file is located. 
*/ 

public CCFPacket (String file) throws AnnouncementExcept ion { 
parse if tie); 

thi9.t:»«Stamp - Timestamp .get.cur rent () ; 

} 

/** 

* Initialises this COP packet by parsing a datagram <UDP) packet. 

* Gparam packet a datagram packet. 
*/ 

public void par (Cat agranPacket packet) throws Announcement Except ion { 

// get sosiion description 
SAPPac«et sap - rullj 
SDPPac^et »<lp - njll; 
try i 

sap • re« *Af racket (packet .getData ()) ; 
sap • new JDrp#citt(3dp.payload) ; 

) 

catch (Hal fomtd $Dt»cept ion e) { 

thro« new A^nnovrxeejentException ,» 
icC3_r.At»e ♦ •. parse: the received announcement cannot be parsed."}* 

> 

this. name - »dp.rva*»»; 

this . descr tption - sdp.info; 

for <int i»0; i * sdp. at tribute, length; i++) { 
String attr - adp. attribute ( il ; 
- if f«ttr — null) i 
continut; 

\ 

if (attr. st art sWith (*lang: •) ) < 

this . langvage - attr .substring (attr . indexOf (':' ) ♦ D.triraO; 

> 

else if tattr.atartsWith<"cat:") ) { 

this. category - attr .substring (attr. indexOf (':' ) + D.triraO; 

) 

else if lattr.atartsWithCX-orag: ") ) { 

this, origin • attr .substring (attr. indexOf (':' ) + D.triraO; 

\ 

else if (•ttE.staxtsWith<"X-seklist :■) ) { 
Vector2 aeklist - new Vector2(); 
StnngTokenirer st - new StringTokenizer 

(attr. substring (attr. indexOf (' ;') + D.trimO* m \ w ); 
whi le ( st . hasMoreTokens ( ) ) ( 

aeklist . addElement ( st . nextToken ( ) . trim ( ) ) ; 

) 

thxs.SCKX.XST - seklist . toStringArray I) ; 

> 

else if (attr-startsWith^X-date:*) ) { 

String date.str - attr . substring (attr . indexOf (':' ) + l).trim(); 
this. date - Long, par seLong (date_str) ; 

> 

else if Cattr.startsWithCX-sched: - ) ) < 

thxs. schedule - attr .substring (attr. indexOf (':' > + D.trimO; 

> 
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} 

this.MADDR = sdp . Connection . address; 
this.MTTL = Integer. parselnt (sdp. connection, ttl) ; 
this.MPORT » Integer, parselnt (sdp. media[0] . getPort ()) ; 
this. id » sdp. origin. session_id; 

} 

/•• 

* Initializes this CDP packet by parsing from a file. 

* Gparam file_path name and path of the CDP announcement file. 
-/ 

public void parse (String file_path> throws AnnouncementException { 
/* 

* Open file. 
V 

File file = new File ( f ile_path) ; 
Buf f eredKeader file_ in - null; 
try ( 

file__in =* new Buf f eredReader ( new FileReader (f ile J ) ; 

) 

catch (FileNotFoundException e) ( 

throw new AnnouncementException 

(obj_name + ".parse: the CDP file cannot be opened."); 

} 

/* 

* Read-in the file line by line. *» 
•/ , . 
while <file_in !- null) ( 

// parse a line 
String line - null; 
try { 

line » f ile.in.readXine O ; 

) 

catch (IOException e) { 
break; 

} 

if (line — null) { // break if eof 
try ( 

f ile_in . close () ; 

\ 

catch (IOException e) { 

} 

break; 

else if (line. start swith ("name=*) ) { 

this. name - line. substring ( line . indexOf ('-' ) + l).trim{); 

> 

else if (line. startsWith ("category*") ) { 

this. category - line . substring (line . indexOf ('-' ) + l).trim(); 

} 

else if (line . startsWith ( "description-" ) ) ( 

this. description - line . substring (line . indexOf ('-' } + l).triro(); 

> 

else if (line. startsWith ("origin-" ) ) ( 

this. origin - line . substring (line . indexOf ( ' -* ) + l).trira(); 

> 

else if (line. startsWith ("language-*) ) ( 

this. language - line. substring (line. indexOf ('-' ) + l).trim(); 

> 

else if (line.startsWith("maddr-") ) { 
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thia.hoCoR * line . substring (line . indexi 
► 

else if (lincstartsWithfrTrport-") ) { 

String port_str - line . substring (line . indexOf ('»' ) + l).trim(); 
this.MPORT « integer .parselnt (port_str) ; 

> 

else if (line.startsWithCmttl-") > < 

String ttl_str a line . substring ( line . indexOf ('»' ) + l).trim<); 
this.MTTL » integer . parselnt (ttl_str) ; 

) 

else if Uine.startsWithCid-") ) ( 

this. id = line, substring (line. indexOf ('-' ) + l).trim(); 

) 

else if (line . startsWith ( "seklist**" ) ) < 
Vector2 seklist « new Vector2(); 
StringTokenizer st - new StringTokenizer 

(line . substring (line. indexOf ('»' ) + D.triroO, "I"); 
while (st . hasMoreTokens ( ) ) { 

seklist .addElement (st . nextToken () .trira( 1 ) ; 

> 

this. seklist => seklist . toStringArray () ; 

> 

else if (line. start sWith ("date-") ) ( 

String date_str » line . substring ( line . indexOf ('-' ) + l).trira(); 
this. date *» Long .parseLong (date_str) ; 

} 

else if (line.startsWith^schedule-") ) { 

this . schedule - line . substring ( line . indexOf ('-' ) + l).trira(); 

> 

else { 
/* 

* Uncomntent below if you want strict formating of the files. 
V 

throw new AnnouncementException 

<obj__ name + ".parse: the CDP file cannot be parsed"); 

) 



} 



/** 

* Composes a datagram packet that represents this CDP packet going out to the 

* specified address and port number. This packet is UDP encapsulated SAP/SDP 

* session announcemnet protocol. All appropriate fields, not defined as 

* <code>null</code>, are used to make up this packet. 
* 

* G pa ram addr destination address string. 

* ©param port destination port number. 

* Greturn a datagram packet consisting of the valid CDP (SAP/SDP) fields. 
*/ 

public DatagramPacket compose (String addr_str, int port) ( 
Vector2 temp_vec - new Vector2(); 
SAPPacket sap - new SAPPacketO; 
SDPPacket adp - new SDPPacketO; 

/* 

* compose sdp 
•/ 

// o 

sdp. origin .username - "cdp"; 
sdp. origin . session_id - id; 

sdp. origin. version - String .valueOf (Time stamp. get_cur rent O ) ; 
sdp. origin .net work_type - •IN"; 
sdp. origin. addre a a_type - "IP4*; 
try ( 
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sdp- origin . addreaa - inetAddress . getLocalHost ( ) . 

\ 

catch (UnknownHost Exception e) ( 

} 

// 3 

if (nane !- null) { 
sdp. nane " name; 

) 

// x 

if idescuption !- null) \ 
sdp. info - description; 

} 

// c 

if < MADOP f- null) ( 

sdp. connect :on - new SDPConnection ( ) ; 
sdp. conntct ion .network., type « "IN"; 
5dp.connect-ion.addre3s_.type - "IP4"; 
sdp. c o nnec t i on. address « MADDR; 
sdp.confttciion.ttl • String . valueOf (MTTL) ; 

) 

// a 

if (category - null) I 

temp_v»c . *act;e**ent i "cat : " + category); 

) 

if (origin ?- null! * 

temp_vec . adcr ie«*«nt * "X-orig : " + origin); 

> 

if (language nulii 4 

temp.vec. »3d*le»ent ( • Lang: ■ + language); pi 
) , ! 

if (SEKLIST null 44 SEKLIST[0] null) { 

String te*p_str - SCri.XST[0]; 
for (int I - It k < 3UU.IST. length; i*+) { 
if ISUCLISTUI null) { 

t#«*p_ttr "I* ♦ SEKIilSTti]; 

} 

) 

temp_vec . eddTleiaent ("X-seklist: ■ + temp_str) ; 

} 

if (date !- -1» « 

terap_vec.add£le»ent ("X-date:" + String . valueOf (date) ) ; 

\ 

if (schedule (• null I i 

tenip_vec.add£le»ent ("X-sched: " + schedule); 

> 

sdp. attribute ■ Ccnp.vec. toStringArray ( ) ; 
// t -permanent session 
sdp. active - new String(l); 
sdp* active (0) - "0 Q m ? 
// m 

sdp.media[0] - new SDPMedia ("audio". String . valueOf (MPORT) , "RTP/AVP"); 
/* 

* compose sap 
*/ 

sap.me33age_type - SAP Packet .MT_ANNOUNCE; 

sap. encrypt ion — false; 

sap. compression • false; 

sap.auth_ headerlen - 0; 

sap.rcsgicL.hash — 0; 

try < 

sap. source - InetAddresa . getLocalHost ( ) . get Address ( ) ; 

> 

catch (UnknownHost Except ion e) { 
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) 

sap. pay load = sdp. compose () ; 
this . data — sap. compose ( ) ; 

met Address addr = null; 
try ( 

addr - Inet Address .getByName (addr_str) ; 

) 

catch (UnknownHostException e) { 
> 

return new DatagramPacket (data, data. length, addr, port); 



* Conposes an ascii file that represents this COP packet. All appropriate 

• fi«lds, not defined as <cod€>null</code>, are used to make up this 

• packet. 
« 

* *p*ram String filename (path) 
•/ 

public void compose (String filename) ( 
file file - new File ( filename) ; 
PnntWriter fout =• null; 

try { 

fout - new PrintWriter (new Buff eredWriter (new Fi leWriter ( f i le) ) ) ; 

) 

catch (lOException e) { ** 

} i * 

if (name !- null) ( 

fout . prxnt In ("name** + name); 

> 

if (description !- null) { 

fout . println ("description-* * description); 

> 

if (category ! - null) ( 

fout .print In ('category—" + category); 

> 

if (origin !- null) < 

fout .println ("origin-" + origin); 

> 

if (language I- null) { 

fout .print In ("language-" + language); 

) 

if (MADDR !- null) < 

fout .print In ("raaddr-" + MADDR); 

> 

if (MPORT !- -1) ( 

fout .print In < "report-* + MPORT); 

> 

if (MTTL !- -1) { 

f out. print In <"rattl- w + MTTL); 

) 

if (id !- null) < 

fout. print In ("id-* + id); 

) 

if (SEKLIST !- null &* SEKLIST(O) !• null) < 
String temp_str - SEKLIST[0); 
for (int i - 1; i < SEKLIST. length; i++) { 
if (SEKXIST(i) !- null) ( 

temp_str +- • I ■ + SEKLIST [ i] ; 

> 

) 
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fout .println ("seklist-" ♦ temp.str); 

} 

if (date !~ -1) < 

fout.println(*date- w + String . valueOf (date) > ; 

> 

if (schedule != null) < 

fout .println ("schedule-" + schedule); 

\ 

try { 

fout .close () ; 

} 

catch (Exception e) ( 
\ 



/»* 

* Composes a datagram packet that represents an empty CDP packet. 

* This packet should be instantiated for receiving purposes. It automatically 

* generates a packet with the internal buffer of the maximum length. 
* 

* @ return a datagram paclcet with empty buffer. 
*/ 

public static DatagramPacJcet compose () { 
byte[] buf =» new byte (MAX_BUFLEN) ; 

return new Dat agramPacket (buf , buf. length); 



} 



* 
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/» marconiNet - Internet Radio Network 
9 Distributed Radio Antenna Server (RAS ) : [MaddrDispenser Class] 
* 

* $<marconi.maddr . >MaddrDispenser , java -vl . 0 (prototype version), 1998/11/11 $ 

* Qjdkl.1.7, -riK. 
*/ 

package marconi .util; 

import java.io.*; 

import java.net.*; 

import java.util .Hashtable; 

/*• 

* The <code>MaddrDispenser</code> class distributes a domain-wide multicast 

* address for each station, where domain refers to reachability of RAS. unlike 

* the class <code>MaddrServer</code> it creates multicast channels between RAS 

* and IRCs. Thus, each RAS must include an instance of this object. And 

* assuming a carefully designed domain edges, different instances can utilize 

* the same addresses. 

* <p> 

* we can use administratively scoped address space here, which will eliminate 

* the problem of RAS-coverage (domain) overlaps. But for simplicity and to avoid 

* having to configure the organizational boundary routers, we simply assume 

* for now that there is a local RAS running and use "site-local" scoping 

* (IPv4 TTL-15) . 

* <p> 
* 

* Qauthor -riK, 

* Qversion $Revision: 1.0 $ *• 

* Qsee marconi.util .MaddrException »« 

* Qsince prototype vl.O 
*/ 

public class MaddrDispenser { 
/* 

* Here we use a contiguous address block £:rora the TTI* scoped 

* multicast address spectrum: 

[225.2.0.0 : 22 5.2.255.255] (site-local iif TTL-15) 

* Note that it avoids the administratively scoped IPv4 multicast space: 

[239.0.0.0 : 239.255.255.255] 

final static int MADDR^LOWBOUND - 0x0000; // [225. 2]. 0.0 

final static int MADD*_UPPERBOUND - OxFFFT; // [225 .2] . 255 . 255 

final static String MADDR_PREFIX - "225.2"; // 225.0.0.0/1$ 

final static String RTCP_PREriX - "225.4"; // 

Hashtable registeredMaddrs - null; 
/•* 

* Creates a new instance of <code>MaddrDispenser</code> where the next 

* multicast address to be allocated is initialized to the lower bound 

* of the address space. All addresses are recycled. 
*/ 

public MaddrDispenser () { 

register edMaddra - new Hashtable <); 

} 

/** 

* Allocates and returns a new multicast address. It will first try to fill-in 

* any holes within its address space. In other words, it recycles freed 

* addresses. 

* » * -. m 

* Qreturn the new multicast address. - 

* ^exception MaddrException if it runs out orMthe given multicast ^address 
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* pool . 
V 

public synchronized InetAddress next (} throws MaddrExcept ion { 

// find an empty multicast address space 
int maddr - MADDR_LOWBOUND; 
InetAddress inet_maddr =■ null; 

while (registeredMaddrs. contains (new Integer (maddr ) ) 
&& ++maddr <=■ MADDR_UPP£RBOUND) ; 

// return newly assigned address 
if (maddr <- MADDR_UPPERBOUND) < 
try { 

inet^ maddr = InetAddress . getByNarae (toSt ring (maddr) ) ; 

\ 

catch (UnJtnownHostException e) ( 
e -printStacJcTrace < ) ; 

) 

registeredMaddrs .put (inet_maddr, new Integer (maddr) ) ; 
return inet_ maddr; 

> 

else { 

throw new MaddrExcept ion ("Multicast address out of bound.*); 

) 

} 

/** 

* Free the address. Return the multicast address back to its pool. 

-* 

* @ pa ram inet_maddr the address to be freed. 
*/ 

public synchronized void remove ( InetAddress inet_maddr) ( 
registeredMaddrs . remove (inet_raaddr) ; 

> 

/* 

* Construct the full IP address format. 
*/ 

protected String toSt ring (int addr) ( 

return MADDR^PREFIX ((addr >» 8) & OxFF) + + (addr 6 OxFF) ; 

> 

/** 

* Return RTCP multicast address of the given RTP multicast address. The details 

* of napping RTP to RTCP address is hidden. 
* 

* Gparam rtp_maddr the RTP multicast address. 
*/ 

public static String rtcp_jnap (InetAddress rtp_maddr) { 
byteU raw - rtp_juaddr .get Address (> ; 

return RTCP_PREFIX + •.• + ((raw{2] « 24) »> 24) + + Uraw[3] « 24) »> 24) ; 

> 

* Return IPv4 address as 32bit integer. 
* 

* Oparam maddr the inet address to be converted. 
V 

public static int addr_to__int ( InetAddress maddr) { 
byte (3 raw — maddr .get Address () ; 
int int32 - raw[0] « 24; 
int32 |- (rawfl] « 24) >» 8; 
int32 I- (raw(2] « 24) »> 16; 
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int32 I- <raw(3] << 24) >>> 24; 
return int32; 

} 

) 
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/* marconiNet - Internet Radio Network 

* Distributed Radio Antenna Server (RAS) : (MaddrServer Class] 

*■ 

* $<marconi . util . >MaddrServer. java -vl . 0 (prototype version), 1998/10/12 $ 

* Gjdkl.2, -riK. 
*/ 

package marconi .util; 

import java. rmi.*; 

import java . rmi . server .* ; 

import java . rmi . registry . LocateRegist ry; 

import java.io.*; 

import java.net.*; 

import java . util . Hashtable; 

/** 

* The <code>MaddrServer</code> class manages the global multicast address 

* allocation to the Radio Station Client (RSC) channels. The current version 

* does not implement distributed approach. Therefore, <code>MaddrServer</code> 

* acts as a centralized server where the RSCs can obtain their multicast 

* addresses via a specific request (RMI request) . 

* <p> 
* 

* Gauthor ~riK. 

* Gversion $Revision: 1.0 $ 

* Gsee marconi .util -MaddrExcept ion 

* Gsince prototype 1.0 
*/ 

public class MaddrServer extends OnicastRemoteOb ject 
implements MaddrServerlnterf { 

final static String obj_ name - "marconi .util •MaddrServer*; 
/•* 

* The port number for multicast address. 
*/ 

public final static int MADDRSERV_PORT - 8889; 
/* 

* Here we use a contiguous address block from the TTL scoped 

* multicast address spectrum: 

[225.1.0,0 : 225.1.255,255] (global iff 128 < TTL < 255) 

* Note that it avoids the administratively scoped IPv4 multicast space: 

* [239.0.0.0 : 239.255.255.255] 
*/ 

final static int MADDH_LOWBOUND - 0x0000; // [225. 1). 0.0 

final static int MADDR^UFPERBOUND - OxFFFF; // [225.1) .255.255 
final static String MADDR^P REF I X - "225.1"; // 225.0.0.0/16 

Hashtable regiateredMaddra - null; 
/** 

* Initializes the multicast address server. 

V 

public MaddrServer () throws RemoteException { 
registeredMaddrs - new Hashtable () ; 

} 

/** 

* Allocates and returns a new multicast address. It will first try to fill-in 

* any holes within its address space. In other words, it recycles freed 

* addresses . 
* 

* 6 return the new multicast address. 
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* ^exception MaddrExcept ion if it runs out. t 

* pooL. 
*/ 

pubLic synchronized inetAddress next 0 

throws RemoteException, MaddrException < 

// find an empty multicast address space 
int maddr - MADDR_LOWBOUND ; 
InetAddress inet_raaddr =■ null; 

while (registeredMaddrs. contains (new Integer (maddr) ) 
&& + +rnaddr <- MADDR_UPPERBOUND) ; 

// return newly assigned address 
if (maddr <= MADDR__UPPERBOUND) { 
try { 

inet_maddr = InetAddress . getByName (toString (maddr) ) ; 

> 

catch (Exception e) { 

e .printStackTrace () ; 

} 

registeredMaddrs. put (inet_maddr, new Integer (maddr) ) ; 
return inet_maddr; 

) 

else ( 

throw new MaddrExcept ion ( "Multicast address out of bound.*); 

) 

} 

/** ?* 

* Free the address. Return the multicast address back to its pool. 4 t 
* 

* Qparam inet_maddr the address to be freed. 
V 

public synchronized void remove (InetAddress inet_maddr) 
throws RemoteException { 
registeredMaddrs . remove (in et_maddr) ; 

I 

/* 

* Construct the full IP address format. 
*/ 

protected String toString (int addr) { 

return MADDR^PREFIX + ■ . ■ + ((addr »> 8) 6 OxFF) * ♦ (addr & OxFF) ; 

> 

/** 

* The main method executes the server setup process. 
V 

public static void main (String args[3) throws RemoteException { 

// check arguments (rtsp server) 
if (args. length !- 0) { 

System. err. println(*usage: \n" ♦ "Maddr Server") ; 

System. exit (-1) ; 

\ 

System. setErr (System. out) ; 

// Create and install a security manager 

System. setSecurityManager (new RMISecurityManager () ) ; 

// Setup and start the server on local host 
try { 

LocateRegistry .createReglstry <MADDRSERV_ PORT) ; 
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ddrSer 



MaddrServer ma<i3rServer - new MaddrServer () ; 
Naming . rebind <"//: " + MADDRSERV__PORT + */" + obj_narae, maddrServer) 
System . out . println ( metAddress . getLocalHost ( ) 

+. ■ bound in registry at port * 
* MAD DRSERV — PORT ) ; 

) 

catch (Exception e) { 

System. err -println (ob j_name + ".main: " + e . getMessage <) ) ; 
e .printStackTrace ( ) ; 

} 
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* EXTENSION OF. . . 

* Q (») Vector . java 1.60 98/09/30 

* Copyright 1994-1998 by Sun Microsystems, Inc., 

* 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. 

* All rights reserved. 
# 

* This software is the confidential and proprietary information 

* of Son Microsystem*, Inc. ("Confidential Information"). rou 

* shall not disclose such Confidential Information and shall use 

* it only in accordance with the terms of the license agreement 

* you entered into with San. 
*/ 

package marconi . ut 1 1 ; 
/** 

* This class extends }ava . ut i 1 . Vector so that it's capable of returning its 

* elements as an array cf )«v* . lang . String . 
* 

* Gautor -riK. 

* Gsee java. ut v 1 .vector 
*/ 

public class Vector J eMt»rv,is ;« va. ut 1 1 .Vector { 
/** 

* Constructs an e«pty vector so that its internal data array 

* has size <tt>10«/tt> and its standard capacity increment is * 

* zero. *r 
•/ r 

public Vector2 ( I I 
super (10); 

> 

* Returns a string array representation of thia Vector, containing 

* the String representation of each element. 
*/ 

public synchronized String I) toStringArray () { 
String (] result • new String (elementCount ] ; 
System, arraycopy (elenentData, 0, result, 0, elementCount); 
return result; 

} 
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'* rnarconiNet - Internet RadKi Network 

* Distributed internet Radio Server (DIRS) : [Maddr Server interface] 

* $<marconi .utii ->Maddr Server Interf. java -vl . 0 (prototype version), 98/8/19. 

* Gjdkl.2, -riK. 
*/ • 

package marconi . util ; 

import java.rmi.*; 

Import java. net . InetAddress; 



* This interface provides centralized distribution of global multicast addresses. 
*/ 

public interface MaddrServerlnterf extends Remote { 

public InetAddress next (] 

throws RemoteException, MaddrException; 

public void remove ( InetAddress maddr) 
throws RemoteException; 



r 



t 
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/* marconiNet - Internet Radio Network 

* Distributed Radio Antenna Server (RAS) : (Base64 Wrapper Class) 
« 

* $<marconi .util->Base64 . java -vl . 0 (prototype version), 1999/05/13 S 

* <3jdkl.2, -riK. 
*/ 

package marcom . ut i 1; 
import java.util.*; 
/•* 

* This class is a Base64 wrapper for ASCII representation of BINARY data. 

* It follows the PEM encoding formula. 

* <p> 
* 

* ^author -riK. 

* Aversion SRevision: 1.0 5 

* <$since prototype vl.O 
»/ 

public class Base 6 4 { 
/*• 

* Maps binary to char. 
V 

private static int map(int c) { 

if <c >« 0 && c <- 25) return<c + 'A'); 

if (c >■» 26 && c <= 51) return(c - 26 + 'a'); 

if (c >= 52 && c <- 61) return(c - 52 + ' 0' ) ; 

if (c — 62) return ('*'); , * 

if (c =— 63) return ('/'); r * 
else return(-l); 

> 

/*• 

* Maps, char to binary. 
*/ 

private static int unmap(int c> < 

if <c >- 'A' i& c <• 'Z'| return (c - 'A'); 

if (c >= 'a' && c <= 'z') return (c + 26 - 'a'); 

if (c >= '0' 66 c <• '9') return (c ♦ 52 - '0'); 

if <c ~ '+*) return (62); 

if <c — '/') return<63); 

else return (-1); 

y 

/** 

* Decodes base64. 
V 

public static byte [3 decode (byte [J string) { 
int length, L, j? 
bytet) buf - (0)| 

if (string — null) { 
return buf; 

) 

length - string. length; 

buf - new byte (< (length / 4) * 3) + 1]; 
for (i - j - 0; i < length; i +- 4, j +- 3) { 
while (i < length 66 string [i] !- ' &6 

! <string[i] >- 'a' 6& string(i) <- ' z' ) fi& 
! (string [i] >* 'A' £6 stringli] <- ' Z' ) &6 
I (string[i] >« '0' £6 stringUl <- '9')) 
buf[j] - (byte) ( (unmap (string [i] > 4 0x3f) « 2); 
if (3tring(i+l] — ' ) ( 
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break; 

) 

buflj) !=• (byte) ( (unmap (string [ i+1 ] ) & 0x30) » 4) ; 
buflj + H - (byte) ( (unmap (string [ i + 1 1 ) & OxOf) << 4) ; 
if (string [i+2] — ' »' ) { 

buf[ 3 +2] « 0; 

break; 

> 

bu?[j+l] l» (byte) ( (unmap(string[i+2] ) & 0x3c) >> 2) ; 
bufl3*2| - (byte) ( (unmap (string [ i+2 J ) & 0x03) << 6); 
xf (stnngli+3) '=') ( 

buSO + 3] = 0; 

break; 

t 

tuM:*2J I- (byte) unmap (string [ i + 3 J ) & 0x3f; 

) 

r«:urr fc-.if; 

} 

/** 

* Encodes ti*t^4, 
*/ 

public 3t«tic byte!) tn:oC« (byte [ ] bin) { 
in: ©LOCri.PM.lXWC - 18; 
int length. cnt; 
bytel; tuf • 101; 

if (bin — null! ( , # 

return tuf ; , j 

} 

length - bin.lengt.l; 

byte ( I ttring • ne« byte [length + 2); 
Systett. arraycopy tbLn, 0, string, 0, length) ; 
cnt - ( ((length • 3) / 3) * 4) + 2; 
cnt <cnt / (»LOCXS_PEIULINE * 4) ) ; 
buf - ne« byte (cnt); 

for (1 - j - cnt - 0; i < length +• 3; i +- 3, j +- 4) { 
buf[jl - (byte) reap ( (string [ij & Oxfc) » 2) ; 
buf[j*l| - (byte) (map (( (string [i ) & 0x03) « 4) I 

( (string [i+1] & OxfO) » 4)>>; 
if (atnng(i + l) — 0) { 

bufO+21 - buf [j+3] - (byte) 

3 4; 

break; 

) 

buf[j+21 - (byte) (map (( (string [i+1] & OxOf) « 2) I 

( (string [i+2] & OxcO) » 6)))? 
if (string (i*2) — 0) < 

bufCjO) - (byte) ' ; 

j 4; 

break; 

> 

buf U*3) - (byte) rnap(string[i+2] 4 0x3f ) ; 
if (cnt >• (BLOCKS_PEH_LINE -1)) { 

buf[j+41 - (byte) ' \n' ; 

buffj+S| - (byte) ' '; 

j 2; 

cnt - 0; 

> 

else cnt++; 

} 

return buf; 
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* Test function. 
»/ 



public static void main(String args (] ) { 

byte[] in- <<byte)0xff, (byte) 0x33, <byte)0x55); 



// byte I ] out - encode (in); 

byte[l out - encode (args (0] .getBytes ()) ; 

System. out .println (new String (out)) ; 

System. out .println (new String (decode (out) ) ) ; 
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/* marconiNet - Internet Radio Network 

* Distributed Radio Antenna Server (RAS) : [Session Description <SDP) Class) 
* 

* 5<marconi .util . sd. >SDPPacket . java -vl . 0 (prototype version), 1999/03/15 $ 

* 9jdkl.2, ~riK. 
*/ 

package marconi .util . sd; 

import java.util.StringTokenizer; 
import marconi .util .Vector2; 

/** 

* This class encapsulates and parses the <code>media</code> field of Session 

* Description Protocol. 

* <p> 
* 

* Gauthor -riK. 

* ©version SRevision: 1.0 $ 

* Gsee marconi . util .sd. SDPPacket 

* Gsince prototype vl.O 
•/ 

public class SDPMedia ( 
/** 

* The session name. 
*/ 

protected String media - null; 

/•* ■ 

* The session information. * 
public String title ° null; 

f ** 

* The media connection information (multiple specification not supported} . 
*/ 

public SDPConnection connection - null; 
■/** 

* The bandwidth information. 
*/ 

public String bandwidth - null; 
/** 

* The encryption Jtey. 
*/ 

public String key — null; 
/•* 

* The media attributes. 
*/ 

public String attributed - null; 
/**' 

* The media type (audio, video, application, ...etc.). 
*/ 

private String mediaType - null; 
/** 

* The transport port to which the media stream will be sent. 
*/ 

private String mediaPort « null; 
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* The transport protocol. 
*/ 

private String mediaTransport *» null; 
/** 

* The media formats. 
*/ 

private String [J mediaFormat = null; 
/** 

* The default constructor with specific format list. 
*/ 

public SDPMedia (St ring type, String port, String transport, String (] format) i 
mediaType « type; 
mediaPort °" port; 
mediaTransport ** transport; 
mediaFormat format; 
media - compose (); 

/** 

* The default constructor with default media format. 
*/ 

public SDPMedia (String type, String port r String transport) ( 
St ring (] fmt = {"0*>; 
mediaType - type; 
mediaPort - port; 
mediaTransport - transport; 

mediaFormat m fmt; , * 

media - compose (); t * 

\ 

/" 

* The constructor. 
*/ 

public SDPMedia (St ring media) { 
this. media ■ media; 
Vector2 temp_vec - new Vector2(); 

StringTokenizer st - new StringTokenizer (media, * *) ; 

if <st .hasMoreTokens () ) i 

this .mediaType - st .nextToken () ; 

) 

if (st .hasMoreTokens () ) { 

this .mediaPort ■ st .nextToken O ; 

) 

if ( st . hasMoreTokens ( ) ) { 

this. mediaTransport - st • nextToken () ; 

► 

while (st .hasMoreTokens () ) { 

temp_vec . addElement (st . nextToken ( > ) ; 

\ 

this .mediaFormat — temp_ vec . toStringArray ( ) ; 

\ 

/** 

* Returns the type of media. This variable is not directly accessible 

* because they are read-only. 
*/ 

public String get Type <) { 
return mediaType; 

} 
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* Returns the port number for media communication. Thia 

* directly accessible because they are read-only. 
*/ 

public String getPortl) { 
return mediaPort; 

) 

/** 

* Returns the transport protocol used. This variable is not directly 

* accessible because they are read-only. 
*/ 

public String getTransport ( ) { 
return mediaTransport; 

} 

/•• 

* Feturns the media format list. This variable is not directly accessible 

* because they are read-only. 
•/ 

public String (1 getFormat O { 
return .nediaFormat ; 

) 

/•• 

* Returns concatenated media description. 
•/ 

protected String compose () < 
String temp_str - 

for (int 1-0; i < mediaForraat . length? i-n*) ( 

temp str - temp_str + ( (i«0) ?••;•")+ mediaFormat I i] ; § * 

) 

return rnediaType ♦ • • + mediaPort +""••■ mediaTransport + * ■ ♦ temp_str; 

) 
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/* marconiNet - Internet Radio Network 
- * Distributed Radio Antenna Server (RAS> : [Session Description (SDP) Class] 



import java.util.*; 
/ * * 

* This class encapsulates and parses the <code>connect ion</code> field of Session 

* Description Protocol. Currently only IP4 address type is defined by the 

* protocol. 

* <p> 
• 

* ^author -riK. 

* Qversion SRevision: 1-0 $ 

* 0see marconi .util . sd . SDPPacket 

* Qsince prototype vl . 0 
*/ 

public class .SDPConnect ion ( 
/*• 

* The type of network. 
*/ 

public String network_type - "IN"; 



public String address_type - W IP4"; 
/** 

* The base multicast address for connection. 
*/ 

public String address • ■■; 
/•* 

* The connection ttl (time to live) • 
*/ 

public String ttl - mm ; 
/** 

* The number of contiguous addresses including the base address* 
*/ 

public String count - 

* Default constructor. The sub fie Ids take the default values. It ia the 

* user's responsibility to make sure that the required subfields are 

* properly initialised. 
*/ 

public SDPConnect ion () ( 
super { ) } 

) 



* Constructor. It does not check for the valid number of subfields. This 

* simple parser uses the default values if the input is short of fields. 

V 

public SDPConnection (String connection) { 

StringTokenizer st - new StringTokeniser (connection, ■ 




* The type of address • 



r 
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if (at.haaMoreTokensO) < 

this . network_type - st.nextTokenO ; 

} 

if <st .hasMoreTokens {) ) < 

this.address_type « st.nextTokenO; 

if <addres3__type.startsWith("IP4"} > < 
if (st .hasMoreTokens () ) < 

String connect ionAddress - st.nextTokenO; 

StringTokenizer szZ = new StringTokenizer (connect ionAddress, V"); 
if (st2 .hasMoreTokens () ) { 

this. address - st2 .nextToken () ; 

> 

if <st2. hasMoreTokens () ) { 

this.ttl - st2 .nextToken ( ) ; 

> 

if (st2. hasMoreTokens () ) { 

this. count =» st2 . nextToken O ; 

} 

) 

) 

else < 

while (st . hasMoreTokens () ) { 

this. address = address +■ " " + st.nextTokenO; 

> 

this, address » address . trim () ; 

} 

) 

** 

/*• S 

* Returns the <code>String</code> of concatenated connection subfields. 

*/ 

protected String compose <) ( 

return networx__type * " " + address_type + • " + address 

+ <address_type.equals("IP4 p ) ? V + ttl + •/" + count : ""); 

} 

) 
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* marconiMet - Internet Radio Network 

- * Distributed Radio Antenna Server (RAS) : [Session Announcement Protocol Class | 
* 

* $<marconi.util.sd.>SAPPacket . java -vl . 0 (prototype version), 1999/03/15 $ 
" * <J jdkl .2, ~riK. 

V 

>ackage marconi .ut il - sd; 

. report marconi .util . Times tamp, - 



* This class encapsulates and parses the Session Announcement Protocol (SAP) 

* Packet. Within it, SDP packet in also encapsulated. Many of the security 

* related fields are still being defined and thus not fully supported in this 

* version. It merely supports the parsing of these fields. For example, the 

* encrypted payload is not parsed and left to be handled by the next version, 

* or an object that extends this, or an object that encapsulates this (parent 

* object) . 

* <p> 

* Included in the packet are the following fields: 

* <ul> 

* <li>version 

* <li>message type 

* <li>encryption bit 

* <li>compression bit 

* <li>authentication header length 

* <li>message id hash 

* <li>originating source 

* <li>authentication header 

* <li>timeout 

* <li>payload 

* </ul> 

* <p> 

* Sauthor -riK. 

* Aversion $ Revision : 1.0$ 

* Qsee marconi . util . sd.MalforroedSDException 

* Gsee marconi .util -sd. SDPPacket 

* G since prototype vl.O 
•/ 

public class SAPPacket implements java. io . Serial izable { 

final static String obj_name - "marconi. util. SAPPacket"; 

/** 

* The version ID. 
*/ 

public final static iAt version - 1; 
/•* 

* The message type. 
*/ 

public byte message_type - MT^ ANNOUNCE ; 
/** 

* The encryption bit. 
*/ 

public boolean encryption - false; 
/** 

* The compression bit. 
*/ 

public boolean compression — false; 
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* The authentication header length. 
V 

public short auth^headerlen - 0; 
/** 

* The message identifier hash. 
V 

public short msgid_hash « 0; 
/** 

* The orginating source. 
V 

public byte () source » new byte [4]; 
/** 

* The authentication header. 
*/ 

public int[] auth_header = null; 
/** 

* The timeout. 
*/ 

public int timeout « 0; 
/** 

* The text payload (if encrypted contains the privacy header field). 
*/ 

public byteM payload - null; 

/** ,! 

* The date and time of the packet created. 
*/ 

public long timeStamp = -1; 
/** 

* The maximum payload buffer length (currently IK bytes as limited by SAP) . 
*/ 

public final static int MAXJUFLEN « 1024? 
/** 

* The <code>announce</code> message type. 
*/ 

public final static int MT_ANNOUNCE - 0; 
/•* 

* The <code>delete</code> message type . 
*/ 

public final static int MT_ DELETE - 1; 
/** 

* Raw data containing the byte-array representation of the packet* 
*/ 

private byte (J data - null; 
/** 

* Creates an empty SAP packet. 
•/ 

public SAPPacketO < 

this. timeStamp - Time st amp. get_j current ( ) ; 

) 

/** 

* Creates SAP packet from a byte array. 
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the byte array that contains SAJP/SDt 



* Gparani 
•/ 

public SAPPacket (byte [ ) buf) throws Malf ormedSDException < 
parse (buf) ; 

this .timeStainp - Time st amp . get_cur rent {) ; 

\ 



* Obtains a SAP packet by parsing a byte array. 
* 

* eparara tuf a byte array that contains SAP/SDP. 
*/ 

public void parse (byte (] buf) throws Malf ormedSDException ( 
int bO. fcl. D2. b3, i - 0; 

// main sap header 
bO - buf U I ; 

bl - lbatli*il << 24) >>> 24; 
b2 = ibaf;i»ri 24) >>> 24; 
b3 « (b'jf;i»J| << 241 >>> 24; 

int rnain.ht^r - CO « 2A \ bl << 16 \ b2 « 8 I b3; 

i 4; 

if (version I i «4in w h«*<s«r & OxeOOOOOOO) »> 29)) ( 
throw n«« Half cc»«3£Dt*cept ion 

(ob).r.«*« ♦ Vpasae; incompatible version received."); 

> 

this .message.* yr« - (oytei < (main_header & OxlcOOOOOO) »> 26); 
this. encrypt ion • <r»*irv_he*der 6 0x02000000) > 0; 
this .compr«9«i»r • (maiOtader & 0x01000000) > 0; 

this .auth_ header len • (abort) ( <main_header & OxOOffOOOO) >» 16); 
this .msgid_ha*& • (short) «main_header & OxOOOOffff); 

// originating source 



this . source (0 | 
this . source ( 1 ) 
this . source (2 I 
this . source ( 3 ) 
i += 4; 



buf HI; 
buf I i*l : ; 
buf U*2: t 
buf UO] j 



r 4) { 



// authentication header 

this .auth_header - new mt (auth_headerlen 1 ; 
for (int j - 0; 3 < aut h_ header len; i +- '•"♦j* 
bO - buf I ij I 

bl - (bufU*U << 24) »> 24; 
b2 - (buf 1 1^21 << 24) »> 24; 
b3 - (buf[iO) « 24) »> 24; 

this . auth_header ( j) - bO « 24 I bl « 16 I b2 « 8 I b3; 

) 

// 32-bit timeout field 

if (encryption) f 
bO - buf til l 

bl - <buf[i*l) « 24) »> 24; 
b2 - <buf[i*2) « 24) »> 24; 
b3 - (buf[iO) « 24) »> 24; 

this. timeout - bO << 24 I bl << 16 I b2 « 8 I b3; 
i +- 4; 

> 

// payload 

int payloadlen - Kath . rain (MAX_BUFLEN r buf. length - i) ; 
this. payload - new byte (payloadlen) ; 

System. arraycopy (buf ff i, this .payload, 0, payloadlen); 
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* Returns the buffer that represents this SAP packet. 
* 

* (Sreturn byte array representation of this SAP packet (including payload) 
V 

public byte[] compose <) < 

int bO, bl, b2, b3, i, j; 

// integrity check 
if (payload -= null) { 
return null; 

} 

if (auth_header !- null) { 

// just in case they don't match 
auth_header len - (short) auth_header. length; 

} 

xnt length = 4 + 4 + auth_headerlen * 4 + 

((encryption) ? 4 : 0) + payload. length; 
data - new byte ( length) ; 

// main header 
bO = version; 
bl =■ message_type; 
b2 = (encryption) ? 1 : 0; 
b3 =» (compression) ? 1 : 0; 



data [01 = (byte) (bO « 5 I bl « 2 

data 1 1) - (byte) (auth_headerlen) ; 

data [21 - (byte) (rasgid_hash » 8); 

data (3) - (byte) (rasgid_hash) ; 

data (4 J » source [01; 

data (5] - source {1J; 

data [6] = source (2 J; 

data £7] = source [3]; 



b2 « 1 I b3); 



// authentication header 

for {j = 0, i - 8; j < auth — header len; i +- ++j*4) { 
data til « (byte) (auth__header [ jl » 24); 
datati+1] - (byte) (auth_header I j) >> 16); 
data[i+2) - (byte) (auth_header ( j) >> 8); 
datati+3] - (byte) (auth_header [ jl ) ; 

) 

// timeout field 
if (encryption) { 

data(i] - (byte) (timeout » 24); 

data[i+l] - (byte) (timeout » 16); 

data [i +2) - (byte) (timeout » 8); 

data[i+3] - (byte) (timeout); 



i 4; 



} 



// payload 

System. arraycopy (payload, 0, data, i, payload. length) ; 



return data; 
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/* marconiNet - Internet Radio Network 

* Distributed Radio Antenna Server (RAS) : (Session Description (SDP) Classl 
* 

* S<marconi.util-sd->SDPOrigin. java -vl . 0 (prototype version), 1999/04/06 S 
* * Gjdkl.2, -riK. 

- */ 

package marconi .util .sd; 

import java. util. StringTokenizex; 

/** ' 

* This class encapsulates and parses the <code>origin</code> field of Session 

* Description Protocol. 

* <p> 
* 

* Sauthor -riK. 

* Aversion SRevision: 1.0 $ 

* Ssee marconi.util.sd. SDPPacket 

* @since prototype vl.O 
•/ 

public class SDPOrigin ( 
/*• 

* The username, 
*/ 

public String username - 
/** 

* The session id. 
*/ 

public String session_id - "0"; 



/** 

* The announcement version. 
*/ 

public String version - "0"; 
/** 

* The type of network. 
*/ 

public String network_type - "IN"; 
/** 

* The type of address. 
V 

public String address_type - "IP4"; 
/** 

* The originating network address. 
*/ 

public String address - ""; 
/•* 

* Default constructor . The subfields take the default values. It is the 

* user's responsibility to make sure that the required subfields are 

* properly initialized. 
*/ 

public SDPOrigin O { 
super ( ) ; 

} 

/** 

* Constructor. It does not check for the valid number of subfields. This 

* simple parser uses the default values if the input is short of fields. 
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*/ 

public SDPOrigin (String origin) { 

StringTokenizer at - new StringTokenizer (origin, " *); 

i f (st . hasMoreTolcens ( ) > < 

this.username = st .nextToken () ; 

1 

if (st . hasMoreToleens ( ) ) { 

this . session_id » st .next Token () ; 

i 

it 1st . hasMoreToker.s () ) i 

tnis. version = st . nextToicen i) ; 

if ist.hasMoreTokensO » ( 

t Ma . net wo r )c_type =» st . nextToicen () ; 

) 

if \ st . hasMoreTokens ( ) ) { 

ini3.«ddr«33_type - at - nextToken ( ) ; 

f 

if * s ? . haiHorf Toners < I ) ( 

tMi.«<Jdrtn - st .nextToicen O ; 

\ 

\ 



/ 



* Returns tht <codt>itring</code> of concatenated origin subf ields . 



protected String co«pci«() 1 

return uitrnm ♦ * • ♦ session_id + " m + version + w • 

♦ nttworn.t yp« ♦ * w + address_type + " * + address; 

> 
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/* marconiNet - internet Radio Network 

* Distributed Radio Antenna Server (RAS) : (Session Description <SDP) Class] 
• 

* $<marconi.util-3d.>SDPPacket. java -vl . 0 (prototype version), 1999/03/15 $ 

* Gjdkl.2, -riK. 
*/ 

package marconi . ut il . sd; 

import java.util . * ; 

import java.io.*; 

import marconi .util .Timestamp; 

import marconi .ut il -Vector2; 

/•• 

* This class encapsulates and parses the Session Description Protocol (SDP) 

* Packet. It coes not support parsing of the full SDP fields but only enough 

* to support CDP (Channel Description Protocol) . Thus, it does not parse into 

* the aubf idea of SDP if they are not to be used for channel description, 

* Further, the parser tolerates other passive errors such as the existence of 

* fields that are not defined. However, the composing and parsing of SDP is 

* 100% compliant with the standard specification. In order to facilitate this 

* the parser strictly checks for the order and the existence of the required 

* fields. 

* <p> 

* The syntax of the SDP fields are given below: 

* <ul> 

* <li>v0 

* <li>o-4lt;usernaxne4gt; Sit/session idtgt; tit ; versiontgt ; 4lt;network typetgt; 

* tit; address typetgt; tit ; addresstgt ; 

* <li>s-tlt; session nametgt; 

* <li>i-tlt; session descriptiontgt ; 

* <li>u-tlt;untgt; 

* <li>e-tlt;eraail addresstgt; 

* <li>p-t It; phone numbertgt; 

* <li>c-tlt; network typetgt; 4 It; address typetgt; tit; connection address 4 gt; 

* <li>b-tlt;raodif iertgt; :4lt;bandwidth-valuetgt; 

* <li>t-4lt; start time4gt; tit; stop tiraetgt; 

* <li>r-tlt; repeat intervaltgt; tit; active durationtgt; tit; list of offsetstgt; 

* <li>z-t It; adjustment timetgt; tit; of f settgt ; ... 

* <li>k-tlt;methodigt; 

* <li>k-tlt;nethodtgt; ; tit; encrypt ion keytgt; 

* <li>a-tlt;attributetgt; 

* <li>a-tlt;attributetgt; : tit; valuetgt; 

* <li>m-tlt;mediatgt; tlt;porttgt; tit; transport tgt; tlt;fmt listtgt; 

* </ul> 

* <p> 
* 

* ^author *riK. 

* Aversion $Revision* 1.0 $ 

* 9 see marconi. ut il. sd.Malf ormedSDExcept ion 

* Qsee marconi. util. ad. SDPOrigin 

* 6 see marconi- util.sd.SDPMedia 

* 8see marconi. ut il . sd. SDPConnect ion 
» Q see marconi. util. 3d. SAPPacket 

* Qsince prototype vl . 0 
*/ 

public class SDPPacket implements java. io . Serializable ( 

final static String obj_narae - "marconi. util .SDPPacket"; 

/•* 

* The protocol version* 
*/ 

public final static int version » 0; 
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/** 

* The owner/creator and session identifier - 
*/ 

public SDPOrigin origin - new SDPOrigin <); 
/*• 

* The session name. 
*/ 

public String name = 9 "; 
/*• 

* The session information . 
*/ 

public String info « null; 
/** 

* The URI of description. 
*/ 

public String uri « null; 
/** 

* The contact email address. 
*/ 

public String [] email « null; 
/** 

* The contact phone number. 
*/ 

public String [] phone - null; *- 

i 

* • 

/** 

* The session level connection information. 
*/ 

public SDPConnection connection =* new SDPConnection () ? 
/** 

* The bandwidth information. 
V 

public String bandwidth - null; 
/** 

* The time zone adjustments. 
*/ 

public String zone - null; 
/** 

* The encryption key. 
*/ 

public String key - null; 
/** 

* The session attributes. 
•/ 

public String [] attribute - null; 
/** 

* The active times <NTP in seconds » Oh on January 1900) . 
*/ 

public String (] active • {"0 0"}; 
/** 

* The repeat times. 

public String [] repeat - null; 
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/•* 

* The media description. 
♦/ 

public SDPMedialJ media - new SDPMedia [MAX_MEDIACOUNT] ; 
/** 

* The date and time of the packet created. 
*/ 

public long timeStamp - -1; 
/** 

* The number of media descriptions - 
*/ 

public int nm - 0; 
/** 

* The maximum number of media descriptions. 
*/ 

public final static int MAX_MED I ACOUNT - 10; 



* Raw data containing the byte-array representation of the packet, if it has 

* one . 
*/ 

private byte U data - null; 
/** 

* Creates an empty SDP packet. 
*/ 

public SDPPacket () { 

this. timeStamp = Times t amp. get_current () ; 

> 

* Creates SDP packet from a (received) SAP pay load. 

* eparara buf a byte array that contains SDP. 
*/ 

public SDPPacket (byte [] buf) throws MalformedSDException ( 
parse (buf) ; 

this, times tamp ~ Times t amp. get_cu r r ent <) ; 

} 

* Creates a SDP packet from a file. 
* 

* Sparam file pathname to where the SDP-file is located. 
*/ 

public SDPPacket (String file) throws MalformedSDException ( 
parse (file) j 

this .timeStamp - Timestamp.get_current () ; 

) 

/** 

* Obtains a SDP packet by parsing the SAP payload. 
* 

* Qparam buf a byte array that contains SAP payload (SDP content) , 
*/ 

public void parse (byte [] buf) throws MalformedSDExceptxon ( 
/* 

* Open packet buffer as stream. 
*/ 
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B-jf f eredHeader bur_in - new Buff eredReader (new 
(new ByteArrayinputStream(buf ) ) ) ; 

try I 

parse (buf__i n > ; 
buf_in. close () ; 

catch (Malf ormedSDException e) { 

throw new Malf ormedSDException 

(obj_name -t ".parse: packet cannot be parsed."); 

> 

catch (IOException e> ( 
) 

) 

* Oocams a SDP packet from a file. 

* 0param tile_path name and path of the 5DP announcement file. 
•/ 

public void parse (String file_ path) throws Malf ormedSDException ( 
/• 

• Open file. 
*/ 

Fxie file = new File (f ile„path) ; 
Buf f eredReader file_in * null; 
try ( 

file__in - new Buff eredReader (new FxleReader (f lie ) ) ; $9 
parse (file_in) ; , * 

f ile_in. close () ; 

) 

catch (FileNotFoundException e) < 
e .printStackTrace () ; 

) 

catch (Malf ormedSDException e) { 

throw new Malf ormedSDException 

(obj_narae +• ".parse: file cannot be parsed."); 

> 

catch (lOException e) { 
) 

> 

* Parse ordered fields. 
V 

protected void parse (Buff eredReader parser) throws Malf ormedSDException { 
boolean perror - false; 

parse_err: 

try { 

Vector2 temp_vec • new Vector2(); 
String line - parser. reaULine () ; 

// v 

if (line !- null && line . startsWith ("v-") ) { 

String v_ str - line. substring (line . indexOf ('»' ) + l).trim(); 

System. out .print In (obj_jiarae + ".parse: " + line); 

if ( Integer. parselnt (v.stt) > this .version) { 
throw new Malf ormedSDException 

(obj^name + ".parse: incompatible version received."); 
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} 

line - parser . readLine O ; 

) 

else { 

perror - true; 
break parse^err; 

) 

// o 

if (line !- null 66 line . startsWith ("o-" ) ) ( 
System. out .print In (obj_narae ♦ ".parse: ■ + line); 

this. origin « new SDPOrigin t line. substring 

(line. indexOf {'-' ) + D.trimO); 
line - parser . readLine O ; 

J 

else { 

perror >■ true; 
break parse_err; 

} 

// 3 

if (line i- null && line .startsWith ("s-"> > ( 

System. out .println <obj — name ♦ ".parse: " + line); 

this, name - line . substring (line. indexOf ('-' ) ♦ D.trimO; 
line « parser . readLine () ; 

} 

else { 

perror m true; 
break parse_ecr; 

} 

If i 

if (line !- null && line .start sWith <• i«") ) < 

System. out .println {obj_name + ".parse: ■ +■ line); 

this -info - line . substring (line .indexOf C ) + D.trimO; 
line - parser. readLine () ; 

\ 

// u 

if (line !- null s*& line. startsWith ("u-") ) { 

Sys tern, out .println ( ob i_name + ".parse: • * line) ; 

this.uri m line . substring (line. IndexOf ('-' ) ♦ D.trimO; 
line - parser .readLine O ; 

) 

// e 

if <terap_v«c.aixe <) > 0) i 

temp_ywc • removeAllElements ( ) ; 

} 

while (line 1* null &£ line. startsWith ("e»") ) { 

Sy st em. out .println (obj_nanie + parse: " + line); 

terap_vec.addElement (line. substring (line. indexOf ('-' ) +1) .trim() ) ; 
line - parser . readLine () ; 

> 

if (temp_yec.3ize0 > 0) ( 

this. email - temp_vec,toStringXrray (> ; 

} 

// P 

if (temp_.vec.size O > 0) ( 
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temp^vec . removeAllElements ( ) ; 

> 

while (line != null line. startsWith ( "p-" ) > ( 

System, out - println (obj^name + ".parse: " + line); 

temp_vec .addElement (line . substring ( line . indexOf (' ) + 1) .trim ( ) ) ; 
line = parser . readLine () ; 

} 

if (temp__vec.size () > 0) ( 

this. phone « temp_vec . toStringArray ( ) ; 

) 

// c 

if (line != null line . startsWith ( "c=" > ) { 

System. out .print in <obj_ name + ".parse: " + line); 

this .connection = new SDPConnection (line . substring 

(line.indexOf (' »' ) + D.trimO); 
line » parser . readLine () ; 

> 

// b 

if (line !=* null && line. startsWith ( "b«" )> ( 
System. out .print In (obj_name + ".parse: " + line); 

this. bandwidth = line . substring (line. indexOf ('-' ) + D.trimO; 

line » parser . readLine (> ; 
) * 9 
N z H 
if (line !« null && line. startsWith ( "z-") ) { 

System. out .println (ob j_name + ".parse: " + line); 

this, zone *» line . substring (line . indexOf ('-' ) + D.trimO; 
line = parser. readLine () ; 

> 

// k 

if (line != null && line. startsWith ( "k->" ) ) { 

this. key =» line, substring (line . indexOf ('-' ) + D.trimO; 
line - parser . readLine O ; 

> 

// a 

if (temp_vec . size ( ) > 0) { 

tempuvec . removeAllElementa < ) $ 

> 

while (line !• null line .startsWith ( "a-") ) { 

System. out .print In (obj^name +■ ".parse: • ♦ line); 

temp_vec . addElement (line .substring (line. indexOf <*-' ) + D.trimO); 
line - parser .readLine <) ; 

} 

if <terop_vec.size O > 0) ( 

this. attribute - temp_vec. toStringArray () ; 

} 

// t 

if (temp.vec.size <) > 0) { 

t emp_vec » removeAl IE lenient s ( ) ; 

> 

while (line !» null && line .startsWith ( "t-") ) ( 
System, out .print In <obj„name + *. parse: ■ + line); 
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terop.vec . addElement ( line . substring (line . indei 
line *■ parser . readLine <) / 

) 

if (temp_vec.size < ) > 0) < 

this. active - temp_vec . toStringArray ( ) ; 

) 

else { 

perror ■ true; 
break parse_err; 

} 

// r 

if (terap_ vec .size ( ) > 0) < 

temp_ vec . removeAHElements ( ) ; 

while (line i=t null && line . start swith ( "r-" ) ) { 

temp_vec.addElement < line . substring ( line . indexOf ('-' ) + 1) .tnm() ) ; 
line - parser . readLine <) ; 

) 

if (temp_vec.size <) > 0) { 

this. repeat = terap_vec . toStringArray O ; 

) 

// m 

while (line !- null && line . start sWith ( w m«" ) ) { 

System. out .println (ob j_name + -.parse: ■ + line); 

if (mn < MAX_MEDIACOUNT) { 
run*-*-; 

this. media [rw-1] - new SDPMedia (line . substring ## 
(line.indexOf ('-' > + D.trimO); , £ 

line " parser. readLine () ; 

// i 

if (line !- null &4 line, start swith ("!-•) ) { 
media (mn-1] -title - line . substring 
(line.indexOf ('-' ) + D.trimO; 
line - parser. readLine O ; 

> 

// c 

if (line 1- null 64 line. startsWith ("c-") ) I 
media [rnn-1] .connection • new SDPConnection 

(line.substringdine.indexOf <'-') + D.trimO), 
line * parser .readLine () ; 

) 

if b 

if (line !- null £6 line, startsWith ( w b- w ) ) { 
media [ran-1] .bandwidth - line. substring 

(line.indexOf ('-' ) ^ D.trimO; 
line - parser.readLine () ; 

) 

// It 

if (line !- null 44 line. startsWith ( •*-•) ) < 
media [ran-1] .key - line. substring 

(line.indexOf ('-' ) + D.trimO? 
line - parser. readLine () ; 

) 

// a 

if (terap_vec.size() > 0) { 

ternp_vec . removeAllElementa ( ) ; 

while (line !- null 44 line. startsWith ("a-") ) { 
temp_vec .addEleraent (line . substring 

(line.indexOf ('-' ) + D.trimO); 
line - parser .readLine () ; 

} 
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if (ternp — vec.size () > o> { 

media {mn-1 ]. attribute = temp_vec . toStringArray ( ) ; 

> 

} 

if (mn ==- 0) < 

perror » true; 
break parse_err; 

I 

y 

catch (IOException e) < 

throw new MaLformedSDException 

(obj_name + ".parse: session description cannot be parsed."); 

) 

/* 

* Uncomment below if strict formating is desired. 
*/ 

if (perror) < 

throw new MaLformedSDException 

<obj_name + ".parse; session description cannot be parsed.*); 

) 

} 

/** 

* Composes a byte array that represents this SDP packet. 

* All appropriate fields, not defined as <code>null</code> # are used 

* to make up this packet. The syntax integrity check is not performed 

* during this process. The <code>Malf ormedSDExcept ion</code> will be #* 

* thrown by the parser when the receiver of this packet tries to parse 

* it. 
* 

* 9 return a byte array consisting of the valid SDP fields in order. 
*/ 

public byte [ ] compose < ) ( 

ByteArrayOutputStream ba - new ByteArrayOutputStream () ; 

PrintWriter ba_out - new PrintWriter (new OutputStreamWriter <ba) , true); 

ba_out .print In ("v— ■ + version); 
if (origin !- null) { 

ba_ out .print In <*o*»" + origin. compose ()) ; 

> 

if (name !« null) ( 

ba_out .print In ("s«" + name); 

} 

if (info !~ null) < 

ba_out .println("i- w + info); 

> 

if (uri !- null) { 

ba_out . print In ("u— • ♦ uri); 

> 

if (email !— null) < 

for (int i - 0; i < email . length; i++) 
if (email I i] !- null) 

ba_out. print In (*e- w + email [i]); 

) 

if (phone 1- null) { 

for (int i - 0; i < phone . length; i++) 
if (phone [i] !- null) 

ba_out. print In ("p-" + phone [i] ); 

) 

if (connection !- null) ( 

ba__out .print In <"e«" + connection, compose ()) ; 

} 
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if (bandwidth !- nui!! ( 

ba^out .println <*b-* ♦ bandwidth); 

} 

if (rone !- null) < 

ba.out -println ("z-* * zone) ; 

) 

if (key !- null) < 

ba_out. print In ("k»" + key); 

) 

if (attribute !- null) < 

for (int i - 0; i < attribute . length; 
if (attribute [ij !=» null) 

ba_out .println ("a-" + attribute [i] ) ; 

) 

if (active !*> null) { 

for (int i - 0; i < act ive - length; i+ + ) 
if (active(i) !- null) 

ba_out .println ("t-" + active [i]); 

) 

if (repeat !» null) { 

for (int i - 0; i < repeat . length; i++) 
if (repeat [i] !- null) 

ba_out .println ("r-* + repeat |i]); 

for (int i - 0; i < media . length; i++) { 
if (mediali) !- null) { 

if (media(i] .media !- null) \ 

ba_out .println Cm-" ♦ media [i] .media) ; 

if (media [i] .title !- null) { 

ba_ out .println (■!-• ♦ media [i] .title) ; 

f (media [i] .connection !- null) ( 

ba_out .println ("c- w + media t ij .connection. compose ()) ; 

f (media [i] .bandwidth !- null) ( 

ba_out .println ("b- w + media (i] .bandwidth) ; 

f (media (i) .key !- null) i 

ba_out .print In <"k-" + media (i] -key) ; 

if (media [i] .attribute !- null) ( 

for (int j - 0; j < mediali] .attribute . length; 
if (media (il .attribute ( j ] I- null) 

bauout. println (*a-* + media ( i] . attribute [ j] ) ; 



> 



) 



} 

data - ba.toByt ©Array <) 
ba_out. close () ; 



return data; 
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